はじめに

オブザーバビリティスタックを で実行 AWS し、数分でテレメトリデータの送信を開始します。

クイックスタート

end-to-endのオブザーバビリティスタックを にデプロイする最も簡単な方法は、 CLI インストーラ AWS です。次のリソースを作成します。

• Amazon OpenSearch Service ドメイン

• Amazon Managed Service for Prometheus ワークスペース

• Amazon OpenSearch Ingestion パイプライン

• オブザーバビリティワークスペースを備えた OpenSearch UI アプリケーション

オプションで、インストーラはサンプルのテレメトリ用に OpenTelemetry Demo を使用して EC2 インスタンスを起動します。

次のコマンドを実行してインストールを開始します。

bash -c "$(curl -fsSL https://raw.githubusercontent.com/opensearch-project/observability-stack/main/install.sh)" -- --deployment-target=aws

インストールには約 15 分かかります。

CDK デプロイ

infrastructure-as-code には、 AWS CDK を使用します。CDK デプロイでは、次の 2 つのスタックが作成されます。

スタック	作成内容	デプロイ所要時間
ObsInfra	OpenSearch ドメイン、Amazon Managed Service for Prometheus ワークスペース、直接クエリデータソース、パイプライン IAM ロール	～17 分
ObservabilityStack	きめ細かなアクセスコントロールマッピング、OpenSearch Ingestion パイプライン、OpenSearch UI アプリケーション、ダッシュボードの初期化、デモワークロード (オプション)	～6 分

次のコマンドを実行してデプロイします。

cd aws/cdk
npm install
cdk deploy --all

詳細については、GitHub の CDK デプロイ README を参照してください。

テレメトリの送信

どちらのデプロイ方法でも、OTLP データを受け入れる OpenSearch Ingestion エンドポイントが作成されます。SigV4 認証を使用してエクスポートするように OTel Collector を設定します。

extensions:
  sigv4auth:
    region: us-west-2
    service: osis

exporters:
  otlphttp/logs:
    logs_endpoint: ${OSIS_ENDPOINT}/v1/logs
    auth: { authenticator: sigv4auth }
    compression: none
  otlphttp/traces:
    traces_endpoint: ${OSIS_ENDPOINT}/v1/traces
    auth: { authenticator: sigv4auth }
    compression: none
  otlphttp/metrics:
    metrics_endpoint: ${OSIS_ENDPOINT}/v1/metrics
    auth: { authenticator: sigv4auth }
    compression: none

注記

データを送信する IAM プリンシパルには、パイプライン ARN に対する osis:Ingestと アクセスaps:RemoteWrite許可が必要です。

詳細情報

テレメトリデータの送信の詳細については、次のリソースを参照してください。

• OpenTelemetry 計測ガイド (言語ごと)

• インフラストラクチャモニタリング (AWS、Docker、Kubernetes、Prometheus)

• OTel Collector の設定

• データパイプラインとバッチ処理

• このガイドの「Amazon OpenSearch Ingestion の概要」