フェーズ 2: デュアルシグナルモードの有効化

1. OTel Collector のインストール

3 min

デュアルモードの AppDynamics エージェントは、OTLP 経由で OpenTelemetry データを送信します。そのデータを受信して Splunk Observability Cloud に転送するために、同じホスト上にコレクターが必要です。

環境変数の確認

インスタンスにはこれらの変数が事前に設定されているはずです。env または以下のコマンドで利用可能であることを確認してください

bash 
echo "REALM=$REALM"
echo "ACCESS_TOKEN=$ACCESS_TOKEN"
echo "INSTANCE=$INSTANCE"

3つすべてに値が設定されている必要があります。いずれかが空の場合は、インストラクターに確認してください。

Splunk OpenTelemetry Collector のインストール

Splunk OTel Collector のインストールスクリプトを実行します。これにより、コレクターが systemd サービスとしてインストールされます

bash 
curl -sSL https://dl.signalfx.com/splunk-otel-collector.sh > /tmp/splunk-otel-collector.sh && \
  sudo sh /tmp/splunk-otel-collector.sh --realm $REALM --deployment-environment ${INSTANCE}-appd-dual --hec-token ${HEC_TOKEN} --hec-url ${HEC_URL}  -- $ACCESS_TOKEN

ここでは --deployment-environment で環境情報を渡し、--hec-token と --hec-url で HEC ログエクスポートの詳細を渡しています。これはログを出力し、相関させるために重要です。

ワークショップ用コレクター設定の適用

デフォルトのコレクター設定は汎用的なものです。これを、AppDynamics エージェントから OTLP を受信し、Splunk Observability Cloud にエクスポートするワークショップ固有の設定に置き換えます。まず、追加する内容を確認しましょう

bash 
vim ~/workshop/appd/collector-config.yaml

processors: の下にある以下のセクションを確認してください

yaml 
  transform/drop_dims_high_cardinality:
      error_mode: ignore
      metric_statements:
        - context: resource
          conditions:
            - Len(resource.attributes) + Len(attributes) > 34
          statements:
            # Delete from datapoint attributes (where the Java agent puts them)
            - delete_key(attributes, "process.command_args") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "process.executable.path") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "process.runtime.description") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "process.runtime.name") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "process.runtime.version") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "process.pid") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "os.description") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "os.version") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "host.arch") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "host.image.id") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "telemetry.distro.name") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "telemetry.distro.version") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "telemetry.sdk.version") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "telemetry.sdk.name") where Len(resource.attributes) + Len(attributes) >= 34
            - delete_key(attributes, "telemetry.sdk.language") where Len(resource.attributes) + Len(attributes) >= 34

            # Add marker
            - set(resource.attributes["cardinality.trimmed"], "true")
transform/drop_dims_high_cardinality プロセッサは、OpenTelemetry Transformation Language (OTTL) を使用して、34 を超える属性を持つメトリクスをチェックします（メトリクスに付随する実際の値もポイントとしてカウントされます）。

transform 設定では、メトリクスの合計属性数が 34 を超えているかどうかを確認し、超えている場合は価値の低い属性を段階的に削除します。
最後に、利用可能なスペースを確認した後、cardinality.trimmed ディメンションを追加して、属性が削除されたメトリクスを簡単に特定できるようにします。

これらの各プロセッサは、設定内のメトリクス用 pipeline: の末尾に含まれています。

次に、そのカスタム設定を agent_config.yaml にコピーします

bash 
sudo cp ~/workshop/appd/collector-config.yaml /etc/otel/collector/agent_config.yaml

コレクターの再起動

新しい設定を反映するために再起動します

bash 
sudo systemctl restart splunk-otel-collector

コレクターの動作確認

bash 
sudo systemctl status splunk-otel-collector --no-pager

ヘルスエンドポイントを確認します

bash 
curl -s http://localhost:13133/ | jq

コレクターは、ポート 4317（gRPC）および 4318（HTTP）で OTLP をリッスンしています。

Last Modified ·