Collector でSmart Agent モニターを使用する

Collector のSmart AgentレシーバーでSmart Agentモニターを使用する方法について説明します。

注意: Smart Agent モニターは非推奨になる予定で、サポート終了時点で Splunk Observability Cloud へのデータ送信はできなくなります。代わりに、ネイティブ OpenTelemetry レシーバーを使用して、OTel Collector でデータを収集できます。「ネイティブ OTel コンポーネントを使用してアプリケーションやサービスを監視する」を参照してください。

Smart Agent レシーバーとそれに関連する拡張機能は Collector のコンポーネントであり、SignalFx Smart Agent のレガシーモニターを Splunk Distribution of OpenTelemetry Collector のパイプラインに追加できるようにします。多くのモニターでは、Smart Agent のリリースバンドルも必要です。このバンドルは、Splunk Distribution of OpenTelemetry Collector がサポートされている x86_64/amd64 プラットフォームにインストールされます。

詳細については、「Smart Agent receiver」および「Collector components」を参照してください。使用可能なアプリケーションモニターのリストについては、「Supported integrations in Splunk Observability Cloud」を参照してください。

OTel のネイティブコンポーネントを使用して、アプリケーションやサービスを監視します。

一部の Smart Agent モニターは非推奨になる予定で、この期間中は重要なセキュリティとバグ修正のみが提供されます。サポートが終了すると、モニターは削除され、サポートされなくなり、Smart Agent レシーバーで使用してデータを Splunk Observability Cloud に送信することができなくなります。

モニターが非推奨になった後は、代わりにネイティブ OTel レシーバーを使用してアプリケーションやサービスを監視できます。使用可能なレシーバーのリストについては、「Collector components: Receivers」を参照してください。

アクティブなアプリケーションインテグレーションまたはモニターで Smart Agent レシーバーを使用する

注: Smart Agent レシーバーは、x86_64/amd64プラットフォームでのみ完全にサポートされています。

Collector に追加する各 Smart Agent モニターについて、smartagent レシーバーと smartagent サービスパイプラインを Collector 構成ファイルに追加します。各 smartagent レシーバーは、対応する Smart Agent モニターのドロップイン置換として機能します。

[discoveryRule] を使用する代わりに、Collector レシーバークリエイターおよびオブザーバ拡張機能を使用します。詳しくは「Receiver creator receiver」を参照してください。

SignalFx Forwarder モニター（非推奨）を使用している場合は、traces と metrics の両方のパイプラインに追加し、各パイプラインのエクスポータとして SAPM エクスポータと SignalFx エクスポータを使用します。詳細については、「エクスポータ」を参照してください。

Smart Agent レシーバーを設定する

さまざまなデータタイプを設定するには、以下を参照してください：

メトリクスを設定する

メトリクスを置換または変更するには、Collector プロセッサを使用します。

イベントを設定する

イベントを送信するモニターがある場合、SignalFxエクスポーターを使用するログパイプラインにそのモニターを追加します。

  • サンプルモニター kubernetes-events、 nagios、processlist、そして telegraf/exec のようなテレグラフ・モニター。

ホスト情報およびその他の有用なディメンションをイベントに追加するリソース検出プロセッサは、特にプロセスリストモニターを使用する場合に、同じパイプラインに含める必要があります。以下の例を参照してください。

メタデータを設定する

ディメンションプロパティまたはタグを更新するモニターがある場合は、Collector の SignalFx レシーバー設定ブロックの [dimensionClients] フィールドに SignalFx エクスポータ名を入力します。

  • サンプルモニター ecs-metadata、heroku-metadata、kubernetes-cluster、openshift-cluster、postgresql、または sql。

この配列フィールドでエクスポータを指定しないと、レシーバーは接続先の Collector パイプラインを使用しようとします。パイプラインの次の要素がディメンションの更新と互換性がなく、単一の SignalFx エクスポータを設定すると、レシーバーはその SignalFx エクスポータを使用します。ディメンションの更新が不要な場合は、空の配列 [[]] を指定して非アクティブ化できます。

Smart Agent ・エクステンション

スマート エージェント拡張機能は、collectd および Python 拡張機能を提供します。拡張機能は、主にデータの処理を伴わないタスクに使用できます。拡張機能の例には、ヘルスモニタリング、サービス検出、データ転送などがあります。拡張機能はオプションです。

設定 YAML ファイルをコピーするには、GitHub の「SignalFx Smart Agent Extension」を参照してください。

設定例

receivers:
   smartagent/postgresql:
      type: postgresql
      host: mypostgresinstance
      port: 5432
      dimensionClients:
         - signalfx
   smartagent/processlist:
      type: processlist
   smartagent/kafka:
      type: collectd/kafka
      host: mykafkabroker
      port: 7099
      clusterName: mykafkacluster
      intervalSeconds: 5

processors:
   resourcedetection:
      detectors:
         - system

exporters:
   signalfx:
      access_token: "${SIGNALFX_ACCESS_TOKEN}"
      realm: us1
   otlphttp:
      access_token: "${SIGNALFX_ACCESS_TOKEN}"
      traces_endpoint: https://ingest.us1.signalfx.com/v2/trace/otlp

service:
   pipelines:
      metrics:
         receivers:
            - smartagent/postgresql
            - smartagent/kafka
            - otlp
         processors:
            - resourcedetection
         exporters:
            - signalfx
      logs:
         receivers:
            - smartagent/processlist
         processors:
            - resourcedetection
         exporters:
            - signalfx
      traces:
         receivers:
            - otlp
         processors:
            - resourcedetection
         exporters:
            - otlphttp