AIX OpenTelemetry

AIX OpenTelemetry は標準の OTLP HTTP/gRPC データを受信し、traces、metrics、logs を受信できます。

設定¶

OpenTelemetry は既定で無効です。

[otel]
# OpenTelemetry 受信エンドポイントを有効にするかどうか。
enabled = false
# 同時処理数と単一リクエストの変換ポイント数に対する保護。
max_concurrent_requests = 8
max_points_per_request = 50000

[otel.tags]
# OpenTelemetry 受信データにのみ追加されます。
# app_env = "prod"

[otel.self_monitor]
# OpenTelemetry 受信エンドポイント自身のメトリクスを報告するかどうか。
enabled = true
interval = "30s"

[otel.http]
# OTLP HTTP 受信エンドポイントを有効にするかどうか。
enabled = false
addr = "127.0.0.1:4318"
# カスタム OTLP HTTP パス。標準の /v1/traces、/v1/metrics、/v1/logs もサポートします。
trace_path = "/otel/v1/traces"
metric_path = "/otel/v1/metrics"
log_path = "/otel/v1/logs"
# HTTP リクエスト本文の最大バイト数。
max_body_size = 16777216
read_timeout = "10s"
write_timeout = "30s"

[otel.grpc]
# OTLP gRPC 受信エンドポイントを有効にするかどうか。
enabled = false
addr = "127.0.0.1:4317"
# gRPC payload の最大バイト数。
max_payload = 16777216

HTTP は設定された /otel/v1/* パスと標準の OTLP HTTP パス /v1/traces、/v1/metrics、/v1/logs の両方をサポートします。

接続先¶

HTTP は既定で 127.0.0.1:4318 を監視し、gRPC は既定で 127.0.0.1:4317 を監視します。リモート接続が必要な場合は、監視アドレスを 0.0.0.0 に変更し、ネットワークポリシーで該当ポートが許可されていることを確認してください。

メトリクス、オブジェクト、ログ¶

OpenTelemetry の受信後は、データ型に応じて対応する DataWay 分類へ書き込まれます。

trace は opentelemetry に書き込まれ、一般的なフィールドには trace_id、span_id、parent_id、resource、duration、message が含まれ、一般的なタグには service、status、span_kind、span_type、source_type が含まれます。

metrics は otel_service に書き込まれ、metric name はフィールド名として使用されます。resource、scope、datapoint attributes はタグに変換され、属性名中の . は _ に変換されます。

logs のソース優先順位は log.source、service.name、既定ソース otel_logs です。ログ本文は message フィールドに書き込まれ、trace_id と span_id はフィールドとして保持されます。

自身のメトリクス¶

datakitaix_otel_receiver¶

OpenTelemetry を有効にすると、[otel.self_monitor] で受信エンドポイント自身のメトリクス報告の有無と報告間隔を制御できます。