Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

OpenTelemetry によるデータインジェスト

View as MarkdownEdit this pageReport an issueSet up docs MCP

すべてのデータは OpenTelemetry (OTel) collector インスタンス経由で ClickStack に取り込まれます。このインスタンスは、ログ、メトリクス、トレース、セッションデータの主要なエントリポイントとして機能します。このインスタンスには、collector の公式 ClickStack distribution を使用することを推奨します。

ユーザーは、language SDKs から、またはインフラストラクチャのメトリクスやログを収集するデータ収集エージェント (agent ロールの OTel collectors や、Fluentd や Vector などのその他の技術) を通じて、この collector にデータを送信します。OpenTelemetry パイプラインのマネージド運用を求めるチーム向けに、Bindplane は、ClickStack へのネイティブな宛先を備えた OpenTelemetry ネイティブのソリューションを提供しており、テレメトリーの収集、処理、ルーティングを簡素化します。

OpenTelemetry データの送信

ClickStack OpenTelemetry collector のインストール

Managed ClickStack にデータを送信するには、OTel collector をゲートウェイ ロールでデプロイする必要があります。OTel 互換のインストルメンテーションは、HTTP または gRPC 経由の OTLP でこの collector にイベントを送信します。

詳細は"collector のデプロイ"を参照してください。

collector へのデータ送信

Managed ClickStack にデータを送信するには、OpenTelemetry インストルメンテーションの送信先を、OpenTelemetry collector が提供する次のエンドポイントに設定してください。

  • HTTP (OTLP): http://localhost:4318
  • gRPC (OTLP): localhost:4317

OpenTelemetry をサポートするlanguage SDKsやテレメトリーライブラリでは、アプリケーションで OTEL_EXPORTER_OTLP_ENDPOINT 環境変数を設定するだけで済みます。

export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318

agent ロールで OTel collector の contrib ディストリビューション をデプロイする場合は、OTLP エクスポーターを使用して ClickStack collector に送信できます。この構造化ログファイルを取り込む agent の設定例を以下に示します。

# clickhouse-agent-config.yaml
receivers:
  filelog:
    include:
      - /opt/data/logs/access-structured.log
    start_at: beginning
    operators:
      - type: json_parser
        timestamp:
          parse_from: attributes.time_local
          layout: '%Y-%m-%d %H:%M:%S'
exporters:
  # HTTP setup
  otlphttp/hdx:
    endpoint: 'http://localhost:4318'
    compression: gzip
 
  # gRPC setup (alternative)
  otlp/hdx:
    endpoint: 'localhost:4317'
    compression: gzip
processors:
  batch:
    timeout: 5s
    send_batch_size: 10000
service:
  telemetry:
    metrics:
      address: 0.0.0.0:9888 # Modified as 2 collectors running on same host
  pipelines:
    logs:
      receivers: [filelog]
      processors: [batch]
      exporters: [otlphttp/hdx]
Navigation