HTTP/S Server ソース

This product is not supported for your selected Datadog site. ().
次で利用可能:

ログ

概要

Observability Pipelines の HTTP/S Server ソースを使用して、HTTP クライアントログを収集します。

Datadog Lambda Forwarder を使用して AWS 提供のログを Observability Pipelines に送信することもできます。

前提条件

To use Observability Pipelines’ HTTP/S Server source, you need the following information available:

  • The HTTP/S server address, such as 0.0.0.0:9997. The Observability Pipelines Worker listens to this socket address for your HTTP client logs.
  • The HTTP authentication password.

セットアップ

Secrets Management について、HTTP/S Server アドレスの識別子、および該当する場合は、プレーン (basic とも呼ばれる) 認証のユーザー名とパスワード、TLS キーパスの識別子のみを入力してください。実際の値を入力しないでください
。

このソースは、パイプラインをセットアップする際に設定します。パイプラインは、UI、API、または Terraform を使用してセットアップできます。このセクションの手順は、UI でソースをセットアップするためのものです。

パイプライン UI で HTTP/S Server ソースを選択した後、

  1. HTTP/S Server アドレスの識別子を入力します。空白のままにすると、デフォルトが使用されます。
    • 注: アドレスの識別子のみを入力してください。実際のアドレスを入力しないでください。
  2. 認証戦略を選択します。Plain を選択した場合、
    • HTTP/S Server のユーザー名とパスワードの識別子を入力してください。空白のままにすると、デフォルトが使用されます。
  3. (オプション) 認証トークンを設定します。詳細については、認証トークンの構成を参照してください。
  4. HTTP メッセージで使用するデコーダーを選択します。HTTP クライアントログは、この形式である必要があります。注: bytesデコーディングを選択した場合、生のログは message フィールドに保存されます。
If you enter secret identifiers and then choose to use environment variables, the environment variable is the identifier entered and prepended with DD_OP_. For example, if you entered PASSWORD_1 for a password identifier, the environment variable for that password is DD_OP_PASSWORD_1.

オプション設定

TLS を有効にする

Toggle the switch to Enable TLS.

  • If you are using Secrets Management, enter the identifier for the key pass. See Secret defaults for the default used if the field is left blank.
  • Enter the following certificate and key files:
    • Server Certificate Path: The path to the certificate file that has been signed by your Certificate Authority (CA) root file in DER, PEM, or CRT (X.509).
    • (Optional) CA Certificate Path: The path to the certificate file that is your Certificate Authority (CA) root file in DER, PEM, or CRT (X.509).
    • (Optional) Private Key Path: The path to the .key private key file that belongs to your Server Certificate Path in DER, PEM, or CRT (PKCS #8) format.
    • Notes:
      • The configuration data directory /var/lib/observability-pipelines-worker/config/ is automatically appended to the file paths. See Advanced Worker Configurations for more information.
      • The file must be readable by the observability-pipelines-worker group and user.
  • (Optional) Toggle Verify certificate to require connecting clients to present a valid client certificate. This enforces mutual TLS (mTLS), where the Worker verifies the identity of each connecting client.

認証トークンの構成

トークンを HTTP リクエストの認証ヘッダーの資格情報として保存する場合、Worker が受信した HTTP リクエストに有効なトークンが含まれているかチェックするように構成できます。有効なトークンを持たないリクエストイベントは破棄されます。Worker は、ヘッダーの代わりにエンドポイントパスや IP アドレスを検索することもできます。

注: Plain認証戦略では、認証トークンを構成できません。

To configure authentication tokens, enable the Configure authentication tokens toggle:

  1. Click Manage Tokens and then Add Token.
  2. Enter the identifier for your token key.
    Note: If you are using environment variables, the environment variable for this token is the identifier you entered prepended with DD_OP_.
  3. (Optional) Enter a field and value if you want to add additional information to logs that are successfully authenticated with this specific token.
  4. Select the path to the token in the Path to Token dropdown menu:
    • Header for a custom header or an authorization header, such as "Authorization: Basic ABCDEF1234567=".
      • Optionally, enter the header name. Note: The header name is case insensitive.
    • Address for an IP address.
    • Path for an endpoint path.

シークレットのデフォルト値

These are the defaults used for secret identifiers and environment variables.

    • HTTP/S Server アドレスの識別子:
      • Observability Pipelines Worker が HTTP クライアントログをリッスンするソケットアドレス (0.0.0.0:9997など) を参照します。
      • デフォルトの識別子は SOURCE_HTTP_SERVER_ADDRESS です。
    • HTTP/S Server TLS パスフレーズの識別子 (TLSが有効な場合):
      • デフォルトの識別子は SOURCE_HTTP_SERVER_KEY_PASS です。
    • プレーン認証を使用している場合、
      • HTTP/S Server のユーザー名識別子:
        • デフォルトの識別子は SOURCE_HTTP_SERVER_USERNAME です。
      • HTTP/S Server のパスワード識別子:
        • デフォルトの識別子は SOURCE_HTTP_SERVER_PASSWORD です。
    • HTTP/S server address:
      • The Observability Pipelines Worker listens to this socket address, such as 0.0.0.0:9997, for your HTTP client logs.
      • The default environment variable is DD_OP_SOURCE_HTTP_SERVER_ADDRESS.
    • If you are using plain authentication:
      • HTTP/S endpoint authentication username.
        • The default environment variable is DD_OP_SOURCE_HTTP_SERVER_USERNAME.
      • HTTP/S endpoint authentication password.
        • The default environment variable is DD_OP_SOURCE_HTTP_SERVER_PASSWORD.

    Datadog Lambda Forwarder を使用して、AWS が提供するログを Observability Pipelines に送信します

    HTTP/S Server ソースを使用して AWS が提供するログを Observability Pipelines に送信するには、

    注: これは Worker バージョン 2.51 以降で利用可能です。

    パイプラインをセットアップ

    1. Navigate to Observability Pipelines.
    2. Select the HTTP Server source:
      1. Select None in the dropdown menu for Authorization strategy.
      2. Select JSON in the dropdown menu for Decoding.
    3. After you set up your destinations and processors, click Next: Install.
    4. On the Install page, enter the HTTP/S Server listener address, such as 0.0.0.0:9997.
    5. Follow the rest of the instructions on the page to install the Worker based on your platform.

    Datadog Lambda Forwarder をデプロイ

    Follow the Datadog Forwarder CloudFormation installation instructions to deploy the Datadog Forwarder. After you have filled in DdApiKey and selected the appropriate DdSite, go to the Log Forwarding (Optional) section. Enter the following information in that section to configure the Forwarder for sending logs to Observability Pipelines:

    1. In the DdUrl field, enter the DNS or IP address of the load balancer or your VM. Note: Datadog recommends fronting your Worker with a load balancer.
    2. Enter the port in the DdPort field, such as 9997.
    3. If you want to encrypt traffic from the Datadog Forwarder to your Observability Pipelines Worker load balancer, you need to create an HTTPS listener and manage a certificate on your load balancer. Consult your cloud provider’s documentation. For example in AWS, see Create an HTTPS listener for your Application Load Balancer for more information.
    4. If you do not need to maintain encryption between the Datadog Forwarder and load balancer, select true in the DdNoSsl dropdown menu.
    5. Click Create stack, and wait for the creation to complete.
    6. You can find the installed forwarder Lambda function under the stack’s Resources tab with the logical ID Forwarder.
    7. Set up triggers for the installed Datadog Forwarder.