2.59. OpenTelemetry

2.59.1. 내부 내용
링크 복사

OpenTelemetry

사용 및 설정 세부 사항은 위의 링크를 참조하십시오.

2.59.2. Maven 조정
링크 복사

code.quarkus.redhat.com에서 이 확장 기능을 사용하여 새 프로젝트를 생성합니다.

또는 기존 프로젝트에 좌표를 추가합니다.

<dependency>
    <groupId>org.apache.camel.quarkus</groupId>
    <artifactId>camel-quarkus-opentelemetry</artifactId>
</dependency>

<dependency>
    <groupId>org.apache.camel.quarkus</groupId>
    <artifactId>camel-quarkus-opentelemetry</artifactId>
</dependency>

Copy to Clipboard

Toggle word wrap

2.59.3. 사용법
링크 복사

확장 기능은 Camel OpenTelemetryTracer 를 자동으로 생성하여 Camel 레지스트리에 바인딩합니다.

캡처된 추적을 추적 시스템으로 보내려면 아래와 같이 application.properties 내에서 일부 속성을 구성해야 합니다.

Identifier for the origin of spans created by the application
For OTLP
For Jaeger

# Identifier for the origin of spans created by the application
quarkus.application.name=my-camel-application

# For OTLP
quarkus.opentelemetry.tracer.exporter.otlp.endpoint=http://localhost:4317

# For Jaeger
quarkus.opentelemetry.tracer.exporter.jaeger.endpoint=http://localhost:14250

Copy to Clipboard

Toggle word wrap

작업하려는 OpenTelemetry 내보내기에 종속성을 추가해야 합니다.

현재 Quarkus는 Jaeger 및 OpenTelemetry Protocol Specification(OTLP)을 지원합니다.

Jaeger의 경우:

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-opentelemetry-exporter-jaeger</artifactId>
</dependency>

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-opentelemetry-exporter-jaeger</artifactId>
</dependency>

Copy to Clipboard

Toggle word wrap

OTLP의 경우:

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-opentelemetry-exporter-otlp</artifactId>
</dependency>

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-opentelemetry-exporter-otlp</artifactId>
</dependency>

Copy to Clipboard

Toggle word wrap

전체 구성 옵션 목록은 Quarkus OpenTelemetry 가이드를 참조하십시오.

경로 끝점은 application.properties 에서 quarkus.camel.opentelemetry.exclude-patterns 라는 속성을 구성하여 추적에서 제외될 수 있습니다. 예를 들면 다음과 같습니다.

Exclude all direct & netty-http endpoints from tracing

# Exclude all direct & netty-http endpoints from tracing
quarkus.camel.opentelemetry.exclude-patterns=direct:*,netty-http:*

Copy to Clipboard

Toggle word wrap

2.59.3.1. CDI 8080 메서드 실행 추적
링크 복사

Camel 경로에서 CDI Quarkus 메서드를 실행할 때 io.opentelemetry.extension.annotations.WithSpan. @WithSpan 으로 주석이 달린 메서드는 새 Span을 생성하고 현재 추적 컨텍스트와 필요한 모든 관계를 설정합니다.

예를 들어 Camel 경로에서 CDI 빈을 조정하려면 먼저 @WithTrace 를 사용하여 적절한 메서드에 주석을 답니다.

@ApplicationScoped
@Named("myBean")
public class MyBean {
    @WithSpan
    public String greet() {
        return "Hello World!";
    }
}

@ApplicationScoped
@Named("myBean")
public class MyBean {
    @WithSpan
    public String greet() {
        return "Hello World!";
    }
}

Copy to Clipboard

Toggle word wrap

다음으로 Camel 경로의 빈을 사용합니다.

중요

기록된 범위의 시퀀스가 올바른지 확인하려면 단축된 .bean() EIP DSL 메서드 대신 full to("bean:") 엔드포인트 URI를 사용해야 합니다.

public class MyRoutes extends RouteBuilder {
    @Override
    public void configure() throws Exception {
        from("direct:executeBean")
                .to("bean:myBean?method=greet");
    }
}

public class MyRoutes extends RouteBuilder {
    @Override
    public void configure() throws Exception {
        from("direct:executeBean")
                .to("bean:myBean?method=greet");
    }
}

Copy to Clipboard

Toggle word wrap

Quarkus OpenTelemetry 가이드 의 CDI 조정에 대한 자세한 정보가 있습니다.

2.59.4. 추가 Camel Quarkus 구성
링크 복사

Expand

구성 속성 유형 Default

구성 속성	유형	Default
`quarkus.camel.opentelemetry.encoding` 헤더 이름을 인코딩해야 하는지 여부를 설정합니다. OpenTelemetry propagators가 대상 시스템과 호환되지 않는 형식으로 헤더 이름 값을 잠재적으로 설정하는 경우에 유용할 수 있습니다. 예를 들어 사양에서 헤더 이름이 유효한 Java 식별자인 JMS의 경우	`boolean`	`false`
`quarkus.camel.opentelemetry.exclude-patterns` 지정된 패턴과 일치하는 끝점 URI의 추적을 비활성화할지 여부를 설정합니다. 패턴은 다음과 같은 형태를 취할 수 있습니다. 1. 끝점 URI와 정확히 일치합니다. 예: platform-http:/some/path 2. 와일드카드 일치 항목입니다. 예: platform-http:* 3. 엔드포인트 URI와 일치하는 정규식입니다. 예: platform-http:/prefix/.*	`string`

lock quarkus.camel.opentelemetry.encoding

헤더 이름을 인코딩해야 하는지 여부를 설정합니다. OpenTelemetry propagators가 대상 시스템과 호환되지 않는 형식으로 헤더 이름 값을 잠재적으로 설정하는 경우에 유용할 수 있습니다. 예를 들어 사양에서 헤더 이름이 유효한 Java 식별자인 JMS의 경우

boolean

false

lock quarkus.camel.opentelemetry.exclude-patterns

지정된 패턴과 일치하는 끝점 URI의 추적을 비활성화할지 여부를 설정합니다. 패턴은 다음과 같은 형태를 취할 수 있습니다.

1. 끝점 URI와 정확히 일치합니다. 예: platform-http:/some/path

2. 와일드카드 일치 항목입니다. 예: platform-http:*

3. 엔드포인트 URI와 일치하는 정규식입니다. 예: platform-http:/prefix/.*

string

lock 구성 속성은 빌드 시 수정되었습니다. 다른 모든 구성 속성은 런타임에 오버라이브할 수 있습니다.

2.59.1. 내부 내용
링크 복사

2.59.2. Maven 조정
링크 복사

2.59.3. 사용법
링크 복사

2.59.3.1. CDI 8080 메서드 실행 추적
링크 복사

2.59.4. 추가 Camel Quarkus 구성
링크 복사

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

2.59. OpenTelemetry

2.59.1. 내부 내용링크 복사링크가 클립보드에 복사되었습니다!

2.59.2. Maven 조정링크 복사링크가 클립보드에 복사되었습니다!

2.59.3. 사용법링크 복사링크가 클립보드에 복사되었습니다!

2.59.3.1. CDI 8080 메서드 실행 추적링크 복사링크가 클립보드에 복사되었습니다!

2.59.4. 추가 Camel Quarkus 구성링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

2.59.1. 내부 내용
링크 복사

2.59.2. Maven 조정
링크 복사

2.59.3. 사용법
링크 복사

2.59.3.1. CDI 8080 메서드 실행 추적
링크 복사

2.59.4. 추가 Camel Quarkus 구성
링크 복사