Splunk Distribution of the OpenTelemetry Collector の利用開始 🔗
Use the Splunk Distribution of the OpenTelemetry Collector to ingest, process, and export metric, trace, and log data and metadata in Splunk Observability Cloud.
Splunk Observability Cloud データモデルの詳細については、Splunk Observability Cloud のデータ型 を参照してください。
OpenTelemetryCollectorは、テレメトリデータを受信、処理、エクスポートするための技術にとらわれない方法です。
プラットフォームにCollectorをインストールしたら、設定ファイルを更新して、使用するCollectorコンポーネント（レシーバー、プロセッサー、エクスポーター）を定義します。ただし、レシーバーとエクスポーターは、次の段落で説明するように、パイプラインに入るまで有効になりません。診断やヘルスチェックなど、OpenTelemetry Collector に追加機能を提供する拡張機能を追加することもできます。使用可能なコンポーネントは、Collector コンポーネント を参照してください。
次に、データの処理方法を決定するために、サービスパイプラインを設定する必要があります。パイプラインセクションでは、レシーバー、プロセッサー、エクスポーターを結びつけ、データが通る経路を設計します。パイプラインは複数定義でき、1つのレシーバーまたはエクスポーター定義を複数のパイプラインで使用できます。また、1つのパイプラインに複数のレシーバーやエクスポーターを含めることもできます。詳しくは パイプラインでデータを処理する を参照してください。
The OpenTelemetry Collector is an open-source project that has a core version and contribution (Contrib) versions. The core version provides receivers, processors, and exporters for general use. The Contrib version provides receivers, processors, and exporters for specific vendors and use cases.
The Splunk Distribution of the OpenTelemetry Collector is a distribution of the OpenTelemetry Collector. It sits on top of the Contrib version, and it bundles components from OpenTelemetry Core, OpenTelemetry Contrib, and other sources to provide data collection for multiple source platforms.
注意
Splunk officially supports the Splunk Distribution of the OpenTelemetry Collector. Splunk only provides best-effort support for the upstream OpenTelemetry Collector. See OpenTelemetry Collector Contribプロジェクトを使用してテレメトリを送信します。 for more information.
Splunk Observability Cloud はどのバージョンの Collector でもネイティブ OTel として動作しますが、Splunk は Splunk ディストリビューションに対してより良いサポート対応を提供することができます。Contrib または Base OpenTelemetry Collector への変更は、オープンソースの審査プロセスを通過する必要があり、時間がかかることがあります。Splunk バージョンを使用する場合、アップデートやホットフィックスは Splunk の管理下にあります。Splunk バージョンの Collector に追加された主要なものはすべて、最終的に Contribunk バージョンに反映されることに注意してください。
また、Splunk ディストリビューションのカスタマイズには、これらの追加機能が含まれています：
Splunk 製品のデフォルトを改善する
メトリクスソースのディスカバリーモード
Automatic discovery and configuration
ログキャプチャ用のFluentd。デフォルトでは無効になっています。
Data flow for the Splunk Distribution of the OpenTelemetry Collector depends on your environment. See the sections for Kubernetes, and Linux and Windows.
For more information on how to configure data pipelines, パイプラインでデータを処理する.
The Splunk Distribution of the OpenTelemetry Collector for Kubernetes ingests, manages and exports data as shown in this diagram:
The Splunk Distribution of the OpenTelemetry Collector for Linux and Windows ingests, manages and exports data as shown in this diagram:
To collect logs with the Splunk Distribution of the OpenTelemetry Collector:
In Kubernetes environments, native OpenTelemetry log collection is supported by default. See more at Collect logs and events with the Collector for Kubernetes.
Linux と Windows 環境 (物理ホストと仮想マシン) では、Universal Forwarder を使用してログを Splunk プラットフォームに送信します。詳しくは Collector で Splunk Universal Forwarder を使用する を参照してください。
注釈
If you wish to collect logs for the target host, install and enable Fluentd in your Collector instance.
If you want to send data to Splunk Enterprise using the Collector:
Kubernetes 環境では、Collector を使用してメトリクスとログを Splunk Enterprise に送信します。トレース収集はサポートされていません。
Linux と Windows 環境 (物理ホストと仮想マシン) では、Universal Forwarder を使用してメトリクスとログを Splunk プラットフォームに送信します。詳細については、Collector で Splunk Universal Forwarder を使用する を参照してください。また、Collector を使用してデータを Splunk プラットフォームに転送することもできますが、このオプションは現在サポートされていません。
To start using the Collector gather the following resources:
リソース |
説明 |
|---|---|
アクセストークン |
アクセストークンを使用して、リソースの使用状況を追跡管理します。 |
レルム |
レルムとは、組織をホストする自己完結型のデプロイです。Splunk レルムを見つけるには、レルムについての注意 を参照してください。 |
ポートとエンドポイント |
公開されているポートをチェックして、環境に競合がないこと、ファイアウォールが設定されていることを確認します。Collector の設定でポートを変更できます。公開ポートとエンドポイント を参照してください。 |
次については、Collector 要件 も参照してください：
Collector は 2 つのモード、ホスト監視（エージェント）モードまたはデータ転送（ゲートウェイ）モードでデプロイできます：
ホストモニター（エージェント）モードでは、Collectorはアプリケーションと共に、またはアプリケーションと同じホスト上で実行されます。
データ転送（ゲートウェイ）モードでは、1つまたは複数のCollectorが、コンテナやデプロイメントなどのスタンドアロン・サービスを実行します。
詳しくは Collector のデプロイモード を参照してください。
Splunk Observability Cloud は Collector をインストールするためのガイド付きセットアップを提供します：
Splunk Observability Cloud にログインします。
ナビゲーションメニューで、 を選択します。
Go to the Available integrations tab, or select Add Integration in the Deployed integrations tab.
Splunk OpenTelemetry Collector セクションで、いずれかのプラットフォームを選択します。
プラットフォームのセットアップガイドに記載されているステップバイステップの手順に従ってください。
The Splunk Distribution of the OpenTelemetry Collector is supported on and packaged for a variety of platforms, including:
Amazon ECS EC2、Amazon Fargate、Ansible、Nomad、PCF、Puppetなどのツールを使用してCollectorをデプロイすることもできます。詳しくは Other Collector deployment tools and options: ECS/EC2, Fargate, Nomad, PCF を参照してください。
その他のコンフィギュレーション・ソース（アルファ版／ベータ版） も参照してください。
Splunk Observability Cloud は、デプロイされた OTel Collector インスタンスのヘルスとステータスに関する情報をすぐに提供する内蔵ダッシュボードを含む、幅広いモニタリング機能を提供します。詳しくは Splunk Observability Cloud の組み込みダッシュボードでCollectorを監視する を参照してください。
Collectorは、zPages拡張 、Collectorに関するライブデータを提供します。zPagesは、トレースやメトリクスを調べるためにバックエンドに依存することなく、プロセス内診断に役立ちます。
After installing the Collector, read はじめに：Collectorを理解して使用する.
Collectorで一般的なアクションやタスクを実行する方法は、Collector を使用します：一般的なタスクの実行方法 を参照してください。例えば、Splunk Distribution of OpenTelemetry Collectorを使用して機密データを削除する、PII を含むテレメトリからデータを取り除く方法を参照してください。
Learn about automatic discovery and configuration (formerly zero configuration auto instrumentation) to detect telemetry data. Automatic discovery allows the Collector to automatically grab traces from your application, and add metrics for certain types of calls. See Discover telemetry sources automatically.
For more information see also:
Collector のトラブルシューティング。これらのトラブルシューティングのテクニックを試し、サポートリクエストを開く方法を学んでください。