Docs » Splunk Distribution of the OpenTelemetry Collector の利用開始 » はじめに：Collectorを理解して使用する » Common configuration options » Configure HTTP

Configure HTTP 🔗

HTTPは、Collectorの個々のレシーバーまたはエクスポーター内で調整できるさまざまな設定を公開しています。

Configure HTTP clients 🔗

エクスポーター でHTTPクライアントを設定するには、以下の設定を使用します：

注釈

Client configuration supports TLS. For more information, see Configure TLS.

  • endpoint。この接続のアドレスとポート

  • tls。Configure TLS を参照

  • headers。HTTPリクエストヘッダーに追加される名前と値のペア

    • Content-LengthやConnectionのような特定のヘッダーは、必要に応じて自動的に書き込まれます。

    • Host ヘッダーはエンドポイント値から自動的に派生します。しかし、この自動割り当ては、 Host フィールドを headers フィールドに明示的に設定することで上書きできます。

    • If the Host header is provided then it overrides Host field in Request. For more information see Go’s Request .

  • read_buffer_size

  • timeout

  • write_buffer_size

  • compression。使用する圧縮タイプ

    • 圧縮タイプの有効な値は、deflate、gzip、snappy、zlib、zstd、none です。

    • 圧縮が none に設定されている場合、すべてのデータは非圧縮として扱われ、それ以外の入力はエラーとなります。

  • max_idle_conns

  • max_idle_conns_per_host

  • max_conns_per_host

  • idle_conn_timeout

  • auth。Configure authentication を参照

  • disable_keep_alives

  • http2_read_idle_timeout

  • http2_ping_timeout

  • cookies

    • [ enabled ]。有効にすると、クライアントはサーバーのレスポンスからクッキーを保存し、以降のリクエストで再利用します。

    • For more information see Go’s CookieJar type documentation.

例：

exporter:
  otlphttp:
    endpoint: otelcol2:55690
    auth:
      authenticator: some-authenticator-extension
    tls:
      ca_file: ca.pem
      cert_file: cert.pem
      key_file: key.pem
    headers:
      test1: "value1"
      "test 2": "value 2"
    compression: zstd
    cookies:
      enabled: true

Configure HTTP servers 🔗

To configure HTTP servers in collector receivers use these settings:

  • cors。レシーバーが異なるオリジンでホストされている場合でも、レシーバーがウェブブラウザからのトレースを受け付けるようにCORSを設定します。

    • 空白のままか、null に設定されている場合、CORSは有効ではありません。

    • CORSパラメータ のリストを参照してください。

      • allowed_origins。受信側へのリクエスト送信が許可されるオリジンのリスト。オリジンには、0文字以上を置き換えるワイルドカード * を含めることができます。任意のオリジンを許可するには、["*"] を設定します。オリジンがリストされていない場合、CORSは有効になりません。

      • allowed_headers。CORSリクエストに、デフォルトのsafelist 以外のヘッダーを含めることを許可します。デフォルトでは、safelistヘッダーとX-Requested-Withが許可されます。任意のリクエストヘッダーを許可するには、["*"] に設定します。

      • max_age。Access-Control-Max-Age ヘッダーの値を設定し、クライアントが CORS プリフライトリクエストに対する応答をキャッシュできるようにします。設定されていない場合、ブラウザはデフォルトの5秒を使用します。詳しくは Access-Control-Max-Age を参照してください。

  • endpoint

  • max_request_body_size。デフォルトでは 20971520 (20MiB)。1回のリクエストで許可されるボディの最大サイズをバイト数で設定します。

  • compression_algorithms

  • tls。Configure TLS を参照

  • auth。Configure authentication を参照

    • request_params。HTTPヘッダーとともに、認証コンテキストに追加するクエリパラメータ名のリスト。

注釈

カスタムキーを使用して 属性プロセッサー を有効にして任意のhttpヘッダーを付加できます。また、"include_metadata" を有効にする必要があります。

例：

receivers:
  otlp:
    protocols:
      http:
        include_metadata: true
        auth:
          request_params:
          - token
          authenticator: some-authenticator-extension
        cors:
          allowed_origins:
            - https://foo.bar.com
            - https://*.test.com
          allowed_headers:
            - Example-Header
          max_age: 7200
        endpoint: 0.0.0.0:55690
        compression_algorithms: ["", "gzip"]

processors:
  attributes:
    actions:
      - key: http.client_ip
        from_context: X-Forwarded-For
        action: upsert

さらに詳しく 🔗

For more details on the available settings refer to HTTP Configuration Settings in OTel’s GitHub repo.

このページは 2024年09月10日 に最終更新されました。