観測可能性パイプラインを設定する

概要

観測可能性パイプラインは、オープンソースの Vector プロジェクトと接続し、インフラストラクチャー全体のログ、メトリクス、トレースのフローを管理および監視することができます。

観測可能性パイプラインの設定は、まず Vector のインストールVector の設定を行い、Datadog API を使って Vector の構成を観測可能性パイプラインに接続することが必要です。

Vector のインストール

クイックスタート

ターミナル

ターミナルで以下の OS に依存しないコマンドを実行すると、Vector の設定方法が表示されます。

curl --proto '=https' --tlsv1.2 -sSf https://sh.vector.dev | bash

コンテナ

コンテナ型の本番環境では、以下のコマンドを実行し、Vector をダウンロード、インストールします。

curl --proto '=https' --tlsv1.2 -sSf https://sh.vector.dev | bash -s -- -y

また、パッケージマネージャー特定のプラットフォームやオペレーティングシステムに基づいて、Vector をインストールすることもできます。

vector --version コマンドを実行し、インストールが成功したことを確認します。

パッケージマネージャーの使用

Vector は、様々な OS やプラットフォームに対応したパッケージマネージャーを幅広くサポートしています。お好みのパッケージマネージャーを使用して Vector をインストールしてください。

特定のプラットフォームやオペレーティングシステム

多くのユーザーは Kubernetes プラットフォームへのインストールを選択しますが、Vector は以下のプラットフォームや OS にインストールすることが可能です。

より詳細な、プラットフォーム別の手順については、Vector のドキュメントを参照してください。

Vector のコンフィギュレーションを設定する

Vector トポロジーは、データの収集、変換、ルーティングの方法を指示するコンフィギュレーションファイルによって定義されます。Vector トポロジーは、ソース、トランスフォーム、シンクの 3 種類のコンポーネントで構成されています。

Vector の構成は TOML、YAML、JSON をサポートしています。Vector のコンフィギュレーションファイルの場所はインストール方法によって異なりますが、ほとんどの Linux ベースのシステムでは、ファイルは /etc/vector/vector.toml で見つけることができます。

Vector の構成が完了している場合は、Vector と観測可能性パイプラインの接続に進んでください。

構成例

例として簡単なパイプラインを設定するために、vector.yaml というコンフィギュレーションファイルを以下のように作成します。

sources:
  in:
    type: stdin
sinks:
  out:
    inputs:
      - in
    type: console
    encoding:
      codec: text

Vector コンフィギュレーションファイルは、複数の Vector コンポーネントを含むことができます。各コンポーネントには、コンポーネントの種類を示すプレフィックスが付き、一意の ID を持ちます。この例では、最初のコンポーネントに sources があり、ID が in のソースコンポーネントを使用しています。このコンポーネント sources.instdin ソースを使用しており、Vector に stdin 経由でデータを受信するように指示しています。

2 つ目のコンポーネント sinks.out はコンソールシンクを使用し、データを標準出力にプリントするように Vector に指示します。encoding.codec オプションは、データをプレーンテキスト (エンコードされていない状態) で表示するように Vector に指示します。

sinks.out コンポーネントの inputs オプションは、このシンクのイベントがどこから来るのかを Vector に知らせます。この場合、イベントはもう 1 つのコンポーネントである sources の ID in から受け取ります。

コマンド vector --config ./vector.yaml を実行し、コンフィギュレーションファイルとともに Vector を起動します。

次のコマンドを実行すると、Hello world! という 1 つのイベントが構成にパイプされます。

echo 'Hello world!' | vector --config ./vector.yaml

Vector の 3 大構成要素であるソース、トランスフォーム、シンクの設定例については、Vector の構成を参照してください。

Vector と観測可能性パイプラインの接続

以下の手順で、Vector の構成を観測可能性パイプラインに接続します。

  • Datadog で、まだ持っていない場合は、サービスアカウントを作成します。サービスアカウントは、Vector と観測可能性パイプラインを接続するために必要なアプリケーションキーを生成するために必要です。
  • Observability Pipelines に進みます。
  • Create Configuration をクリックし、アプリ内の説明に従って構成の設定を行います。

設定が完了すると、Vector は観測可能性パイプラインに接続され、データは Datadog アプリに表示されます。

その他の参考資料