OpenTelemetry のログとサービスの関連付け

OpenTelemetry コレクターをスタンドアロン実行ファイルまたはサービスとして展開し、 Linux のシステムログや Windows のイベントログを監視する場合、ログとサービスを関連付けるために、各ログレコードにサービス名を手動で割り当てる必要があります。

以下の例のように、属性を service.name 追加できます：

processors:
  transform/enrich_with_service_name:
    error_mode: ignore
    log_statements:
      - context: log
        statements:
          ## Set a "service.name" resource attribute only if the log record is from a specific file.
          ## Example checking the exact file path.
          - set(attributes["service.name"], "My Service 1") where attributes["log.file.path"] == "/path/to/service-1.log"
          ## Example using a regular expression to match a file path.
          - set(attributes["service.name"], "My Service 2") where IsMatch(attributes["log.file.path"], ".*(service-2-dir-name).*")
          ## Example using a custom-defined environment variable with a regex condition on the file path.
          ## Note: This example assumes that the environment variable MY_OTEL_SERVICE_NAME is contains
          ##       the desired service name. You may use any environment variable for this purpose.
          - set(attributes["service.name"], "${env:MY_OTEL_SERVICE_NAME}") where IsMatch(attributes["log.file.path"], ".*(some-otel-service-name).*")
          ## Example using the log path to set the service name dynamically using a named capture group in the regex
          ## to extract the project name as the "service_name" for multiple services with "projects" in their file path.
          - set(attributes["service.name"], ExtractPatterns(attributes["log.file.path"], ".*/projects/(?P<service_name>[^/]+)")["service_name"]) where IsMatch(attributes["log.file.path"], ".*(projects).*")
[...]
service:
  pipelines:
    logs:
      processors:
        # Add other processors here.
        - transform/enrich_with_service_name
        # Always recommended to batch log records.
        - batch

OpenTelemetry コレクターを使用して Kubernetes サービスを監視する場合、 Kubernetes のPod構成やメタデータフィールドを抽出するプロセッサを使用することで k8sattributes 、各ログレコードに属性を service.name 追加できます。

「 Helm 」チャートを使用して OpenTelemetry コレクターをインストールすると、ファイル opentelemetry-collector/templates/_config.tpl 内の事前 k8sattributes 設定済みのプロセッサを利用できるようになります。

いずれの場合も、サービス相関を有効にするために、プロセッサの設定 k8sattributes にこの service.name フィールドが含まれていることを確認してください：

processors:
  k8sattributes:
    extract:
      metadata:
        ## Here add any additional metadata you want to extract from the k8s environment.
        ## For the full list of supported attributes: https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/processor/k8sattributesprocessor/README.md
        - "service.name"  ## Allows logs to be correlated to specific services by Instana.
        - "k8s.pod.uid"   ## If container.id is unavailable, logs are correlated to a specific Kubernetes pod.
        - "container.id"  ## If this field is available, logs are correlated to specific containers in a Kubernetes pod.
[...]
service:
  pipelines:
    logs:
      processors:
        # Add other processors here.
        - k8sattributes
        # Always recommended to batch log records.
        - batch