OpenTelemetry 데이터를 Instana 백엔드로 전송

• 백엔드 otlp-acceptor 컴포넌트의 특수 엔드포인트는 OpenTelemetry 데이터가 전송될 때 사용됩니다.

  다음 구성 예시에서는 OpenTelemetry 수집기를 사용하여 Instana 백엔드 otlp-acceptor 구성 요소에 연결합니다:

  exporters:
    otlp:
      endpoint: ${INSTANA_OTLP_GRPC_BACKEND}:4317
      headers:
        x-instana-key: xxxxxxx

  에 추가된 값은 https:// 보안 otlp. endpoint 연결이 사용됨을 나타냅니다. tls가 설정되어 있지 않으면 기본적으로 활성화됩니다. 자세한 내용은 OtlpExporter 설정에서 확인하십시오.

• 검증을 위해 필수적인 Instana 에이전트 키를 설정해야 합니다. Instana 백엔드를 타겟팅하려면 x-instana-key 필드에 Instana 의 에이전트 키를 설정하십시오.

Instana 백엔드에서는, faas.id, 또는 device.id host.id리소스 속성이 필요합니다. 또는 x-instana-host를 환경 변수로 설정할 수 있습니다. Instana 속성을 host.id 사용하여 호스트를 고유하게 식별하고, OpenTelemetry 엔터티를 올바른 호스트에 연결합니다. 다음 두 가지 방법으로 host.id 제공할 수 있습니다:

• OpenTelemetry SDK를 사용하여 (컨테이너화되지 않은 시스템의 경우 권장)

  OpenTelemetry 에 대한 표준적인 의미론적 host.id 규칙이 있습니다. 대부분의 OpenTelemetry SDK는 컨테이너화되지 않은 시스템에서 리소스 host.id 속성을 수집하는 기능을 지원합니다. OpenTelemetry SDK를 통해 host.id 데이터를 제공하면, Instana 는 OpenTelemetry 엔터티를 Instana 인프라 모니터링의 해당 호스트와 원활하게 연결할 수 있습니다.

• Instana UI에서 host.id 불러오기

  Instana UI에서 host.id 를 찾으려면 ‘인프라 > 인프라 분석 ’으로 이동하세요. ‘엔티티 유형’ 아래에 표시된 ‘호스트’를 클릭합니다. 목록에서 확인하려는 호스트를 클릭하면 해당 호스트의 세부 정보를 볼 수 있습니다. ‘시스템 ’ 항목에서 호스트 ID를 확인할 수 있습니다. OpenTelemetry 리소스 속성에서 host.id 이 항목을 수동으로 설정하면, Instana 은 OpenTelemetry 엔터티를 Instana 인프라 모니터링의 해당 호스트에 연결합니다.

OpenTelemetry 콜렉터가 디먼 세트 모드로 배치된 경우 OpenTelemetry 콜렉터는 OpenTelemetry 데이터를 전송하는 애플리케이션의 동일한 호스트에 있습니다. OTLP 내보내기 도구를 사용하여 x-instana-host 헤더를 설정할 수도 있습니다.

exporters:
  otlp:
    endpoint: ${INSTANA_OTLP_GRPC_BACKEND}:4317
    headers:
      x-instana-key: xxxxxxx
      x-instana-host: xxxx // or use ${host.name} if set in the configuration files processors.resource.attributes or in the OpenTelemetry SDK

• Instana 백엔드를 타겟팅하려면 해당 x-instana-key 필드에 Instana 에이전트의 에이전트 키를 설정하십시오.
• 호스트 이름이 포함된 필드의 x-instana-host 값을 OpenTelemetry 수집기를 실행하는 호스트의 이름인 으로 ${host.name} 설정하십시오. host.name 는 구성 파일( processors.resource.attributes )이나 OpenTelemetry SDK에서 확인할 수 있습니다. host.name 가 설정되어 있지 않은 경우, 환경 변수(예: `hostname` HOSTHOSTNAME 또는 `PATH`)를 통해 호스트 이름을 설정하거나 수동으로 설정할 수 있습니다.
• Instana 백엔드의 구성 otlp-acceptor 요소에 해당하는 올바른 도메인 이름을 해당 endpoint 필드에 입력하십시오.
• Instana 에서 사용하는 OTLP 포트 번호에 대한 자세한 내용은 ‘포트 번호’를 참조하십시오.

Instana 자체 호스팅 환경에서는 포트 443이 및 OTLP/HTTP OTLP/gRPC 프로토콜에 사용됩니다. 다음 도메인 이름이 프로토콜에 사용됩니다.

OTLP/HTTP 용 OTLP/gRPC otlp-http.<base_domain> 의 경우 otlp-grpc.<base_domain>

OpenTelemetry 데이터를 Instana 백엔드로 전송하려면 다음 단계를 따르십시오:

1. Instana 백엔드의 구성 otlp-acceptor 요소에 대해 두 개의 DNS 항목과 otlp-grpc.<basedomain>otlp-http.<base_domain> 가 생성되었는지 확인하십시오.

   • Instana 의 자체 호스팅형 Standard Edition 에서 DNS 구성에 대한 자세한 내용은 단일 노드 클러스터 DNS 설정 및 다중 노드 클러스터 DNS 설정을 참조하십시오.
   • Kubernetes 플랫폼에서 Instana 자체 호스팅 Custom Edition의 DNS 구성에 대한 자세한 내용은 로드 밸런서 설정 및 DNS 을 참조하십시오.
   • Openshift 플랫폼에서 자체 호스팅형 Instana Custom Edition을 구성하는 방법에 대한 자세한 내용은 “Openshift에서 로드 밸런서 설정” 및 “ DNS - Instana 백엔드” 문서를 참조하십시오.

2. ‘ OTLP ’ 익스포터를 ‘ OpenTelemetry ’ 컬렉터와 함께 사용하도록 구성하고 다음 단계 중 하나를 완료하십시오:

   • OTLP 인증 확인이 완료된 수출업체:

     1. 자체 호스팅된 인스턴스에서 CA 파일 가져오기

        • 자체 호스팅된 표준 에디션의 경우:

          kubectl get secret instana-tls -n instana-core -o jsonpath='{.data.ca\.crt}'|base64 -d > ca.crt

        • 인증서가 openssl 명령에 의해 생성되는 자체 호스팅된 사용자 정의 에디션의 경우:

          kubectl get secret instana-tls -n instana-core -o jsonpath='{.data.tls\.crt}'|base64 -d > tls.crt

     2. ca.crt 를 OpenTelemetry 콜렉터 환경의 위치에 복사하십시오.

        exporters:
          otlp:
            endpoint: https://otlp-grpc.<base_domain>:443
            tls:
              insecure: false
              ca_file: <path_to_cert_file>/<cert_file_name>
            headers:
              x-instana-key: xxxxxx
              x-instana-host: xxxxxx // or use ${host.name} if set in the configuration files processors.resource.attributes or in the OpenTelemetry SDK

   • OTLP 인증 확인을 거치지 않은 수출업체:

     exporters:
        otlp:
          endpoint: https://otlp-grpc.<base_domain>:443
          tls:
            insecure: false
            insecure_skip_verify: true
          headers:
            x-instana-key: xxxxxx
            x-instana-host: xxxxxx // or use ${host.name} if set in the configuration files processors.resource.attributes or in the OpenTelemetry SDK

OpenTelemetry 데이터를 Instana 백엔드로 전달하려면 다음 단계를 수행하십시오:

1. Instana 배포 리전을 확인하십시오. Instana 백엔드의 엔드포인트는 배포 지역에 따라 다릅니다. 사용 중인 환경에 할당된 Instana 리전을 확인하려면, Instana UI에서 탐색 메뉴로 이동한 다음 [더 보기 ] > [ Instana 정보 ]를 클릭하십시오. ‘ Instana ’ 대화 상자가 표시됩니다. 대화 상자에서 ‘ Instana ’ 배포 지역을 확인할 수 있습니다.

   각 Instana SaaS 환경은, red, green orange,, 또는 과 같은 특정 지역 bluecoral이름과 연결되어 있습니다. 백엔드의 Instana 엔드포인트에 대한 otlp-acceptor 자세한 내용은 다음을 참조하십시오 백엔드 Instana otlp-acceptor의 엔드포인트.

2. Instana 백엔드에 대한 또는 OTLP/HTTP OTLP/gRPC 연결을 구성합니다. 예를 들어, Instanablue 환경을 사용하는 경우 다음 구성을 통해 Instana 백엔드에 대한 또는 OTLP/HTTP OTLP/gRPC 연결을 설정할 수 있습니다:

   • OTLP/gRPC

     exporters:
       otlp:
         endpoint: otlp-blue-saas.instana.io:4317
         headers:
           x-instana-key: xxxx
     ...
     service:
       pipelines:
         traces:
           receivers: [...]
           processors: [...]
           exporters: [..., otlp]
         metrics:
           receivers: [...]
           processors: [...]
           exporters: [..., otlp]
         logs:
           receivers: [...]
           processors: [...]
           exporters: [..., otlp]

     Instana 백엔드를 타겟팅하려면 해당 x-instana-key 필드에 Instana 에이전트의 에이전트 키를 설정하십시오.

   • OTLP/HTTP

     exporters:
       otlphttp:
         endpoint: https://otlp-blue-saas.instana.io:4318
         headers:
           x-instana-key: xxxx
     ...
     service:
       pipelines:
         traces:
           receivers: [...]
           processors: [...]
           exporters: [..., otlphttp]
         metrics:
           receivers: [...]
           processors: [...]
           exporters: [..., otlphttp]
         logs:
           receivers: [...]
           processors: [...]
           exporters: [..., otlphttp]

다음 표에서는 다양한 Instana SaaS 환경에 대한 Instanaotlp-acceptor 백엔드의 도메인 이름을 확인할 수 있습니다. 환경에 InstanaSaaS 대한 자세한 내용은 다음을 참조하십시오 Collector를 OpenTelemetry 사용하여 OpenTelemetry 통합하기.