ログの収集とインテグレーション

概要

以下のコンフィギュレーションオプションを選択して、ログの取り込みを開始します。すでに log-shipper デーモンを使用している場合は、RsyslogSyslog-ngNXlogFluentD、または Logstash の専用ドキュメントを参照してください。

ログを Datadog に直接送信する場合は、使用可能な Datadog ログ収集エンドポイントのリストを参照してください。

: ログを JSON 形式で Datadog に送信する場合は、Datadog 内にある特定の予約属性を使用します。詳細については、予約属性セクションをご覧ください。

セットアップ

  1. Datadog Agent をインストールします。
  2. ログ収集を有効にするには、Agent のメインコンフィギュレーションファイル (datadog.yaml) で logs_enabled: falselogs_enabled: true に変更します。より詳細な情報と例については、ホスト Agent ログ収集のドキュメントを参照してください。
  3. Datadog Agent を有効にすると、ログファイルの尾行または UDP/TCP 経由で送信されるログのリスニングログのフィルタリングまたは機密データのスクラビング複数行ログの集約を構成することができるようになります。
  1. Datadog Agent をインストールします。
  2. ログ収集を有効にするには、Agent のメインコンフィギュレーションファイル (datadog.yaml) で logs_enabled: falselogs_enabled: true に変更します。より詳細な情報と例については、ホスト Agent ログ収集のドキュメントを参照してください。
  3. アプリケーション言語のインストール手順に従い、ロガーを構成し、ログの生成を開始します。
Java
Python
go
Ruby
.Net
PHP
Node.js
Javascript
React Native
Android
ios
Flutter
Roku
Kotlin Multiplatform

コンテナまたはオーケストレーターのプロバイダーを選択し、そのプロバイダー専用のログ収集手順に従います。

Docker
Kubernetes
Red Hat OpenShift
Amazon ECS
ECS Fargate

:

環境から Datadog にログを送信する AWS Lambda 関数である Datadog Forwarder を使用します。AWS サーバーレス環境でログ収集を有効にするには、Datadog Forwarder のドキュメントを参照してください。

以下からクラウドプロバイダーを選択すると、ログを自動的に収集して Datadog に転送する方法を確認できます。

Docker
Kubernetes
Amazon ECS
Amazon ECS

Datadog のインテグレーションとログ収集は連携しています。インテグレーションのデフォルト構成ファイルを使用すると、Datadog で専用のプロセッサーパース、およびファセットを有効にできます。インテグレーションでログ収集を開始するには:

  1. インテグレーションページからインテグレーションを選択し、セットアップの指示に従います。
  2. インテグレーションが提供するログ収集の手順に従ってください。このセクションでは、そのインテグレーションの conf.yaml ファイルにある logs セクションのコメントを解除し、環境に合わせて構成する方法について説明します。

追加のコンフィギュレーションオプション

ログのエンドポイント

Datadog では、SSL で暗号化された接続と暗号化されていない接続の両方にログのエンドポイントが提供されます。可能な場合は常に、暗号化されたエンドポイントを使用してください。Datadog Agent では、暗号化されたエンドポイントを使用して、ログが Datadog に送信されます。詳細は、Datadog のセキュリティに関するドキュメントで確認できます。

サポートされるエンドポイント

ページの右側にあるサイトセレクターのドロップダウンを使用して、Datadog サイトごとにサポートされているエンドポイントを確認できます。

サイトタイプエンドポイントポート説明
USHTTPShttp-intake.logs.datadoghq.com443HTTPS 経由で JSON またはプレーンテキスト形式のログを送信するためにカスタムフォワーダーが使用。Logs HTTP API のドキュメント参照。
USHTTPSagent-http-intake-pci.logs.datadoghq.com443Agent が PCI DSS コンプライアンスを有効にした組織へ HTTPS でログを送信するために使用します。詳しくは、ログ管理のための PCI DSS コンプライアンスを参照してください。
USHTTPSagent-http-intake.logs.datadoghq.com443HTTPS 経由で JSON 形式のログを送信するために Agent が使用。ホスト Agent ログ収集のドキュメント参照。
USHTTPSlambda-http-intake.logs.datadoghq.com443HTTPS 経由で未加工、Syslog、または JSON 形式のログを送信するために Lambda 関数が使用。
USHTTPSlogs.443Browser SDK が HTTPS で JSON 形式のログを送信するために使用します。
USTCPagent-intake.logs.datadoghq.com10514Agent が TLS を使わずにログを送信するために使用します。
USTCP と TLSagent-intake.logs.datadoghq.com10516Agent が TLS を使ってログを送信するために使用します。
USTCP と TLSintake.logs.datadoghq.com443SSL で暗号化された TCP 接続を介してカスタムフォワーダーが生ログ、Syslog、または JSON 形式のログを送信する際に使用されます。
USTCP と TLSfunctions-intake.logs.datadoghq.com443SSL で暗号化された TCP 接続を介して Azure 関数が生ログ、Syslog、または JSON 形式のログを送信する際に使用されます。: 他のクラウドプロバイダーもこのエンドポイントを使用できます。
USTCP と TLSlambda-intake.logs.datadoghq.com443SSL で暗号化された TCP 接続を介して Lambda 関数が生ログ、Syslog、または JSON 形式のログを送信する際に使用されます。

サイトタイプエンドポイントポート説明
EUHTTPShttp-intake.logs.datadoghq.eu443HTTPS 経由で JSON またはプレーンテキスト形式のログを送信するためにカスタムフォワーダーが使用。Logs HTTP API のドキュメント参照。
EUHTTPSagent-http-intake.logs.datadoghq.eu443HTTPS 経由で JSON 形式のログを送信するために Agent が使用。ホスト Agent ログ収集のドキュメント参照。
EUHTTPSlambda-http-intake.logs.datadoghq.eu443HTTPS 経由で未加工、Syslog、または JSON 形式のログを送信するために Lambda 関数が使用。
EUHTTPSlogs.443Browser SDK が HTTPS で JSON 形式のログを送信するために使用します。
EUTCP と TLSagent-intake.logs.datadoghq.eu443SSL で暗号化された TCP 接続を介して Agent が protobuf 形式のログを送信する際に使用されます。
EUTCP と TLSfunctions-intake.logs.datadoghq.eu443SSL で暗号化された TCP 接続を介して Azure 関数が生ログ、Syslog、または JSON 形式のログを送信する際に使用されます。: 他のクラウドプロバイダーもこのエンドポイントを使用できます。
EUTCP と TLSlambda-intake.logs.datadoghq.eu443SSL で暗号化された TCP 接続を介して Lambda 関数が生ログ、Syslog、または JSON 形式のログを送信する際に使用されます。

サイトタイプエンドポイントポート説明
US3HTTPShttp-intake.logs.us3.datadoghq.com443HTTPS 経由で JSON またはプレーンテキスト形式のログを送信するためにカスタムフォワーダーが使用。Logs HTTP API のドキュメント参照。
US3HTTPSlambda-http-intake.logs.us3.datadoghq.com443HTTPS 経由で未加工、Syslog、または JSON 形式のログを送信するために Lambda 関数が使用。
US3HTTPSagent-http-intake.logs.us3.datadoghq.com443HTTPS 経由で JSON 形式のログを送信するために Agent が使用。ホスト Agent ログ収集のドキュメント参照。
US3HTTPSlogs.443Browser SDK が HTTPS で JSON 形式のログを送信するために使用します。

サイトタイプエンドポイントポート説明
US5HTTPShttp-intake.logs.us5.datadoghq.com443HTTPS 経由で JSON またはプレーンテキスト形式のログを送信するためにカスタムフォワーダーが使用。Logs HTTP API のドキュメント参照。
US5HTTPSlambda-http-intake.logs.us5.datadoghq.com443HTTPS 経由で未加工、Syslog、または JSON 形式のログを送信するために Lambda 関数が使用。
US5HTTPSagent-http-intake.logs.us5.datadoghq.com443HTTPS 経由で JSON 形式のログを送信するために Agent が使用。ホスト Agent ログ収集のドキュメント参照。
US5HTTPSlogs.443Browser SDK が HTTPS で JSON 形式のログを送信するために使用します。

サイトタイプエンドポイントポート説明
AP1HTTPShttp-intake.logs.ap1.datadoghq.com443HTTPS 経由で JSON またはプレーンテキスト形式のログを送信するためにカスタムフォワーダーが使用。Logs HTTP API のドキュメント参照。
AP1HTTPSlambda-http-intake.logs.ap1.datadoghq.com443HTTPS 経由で未加工、Syslog、または JSON 形式のログを送信するために Lambda 関数が使用。
AP1HTTPSagent-http-intake.logs.ap1.datadoghq.com443HTTPS 経由で JSON 形式のログを送信するために Agent が使用。ホスト Agent ログ収集のドキュメント参照。
AP1HTTPSlogs.443Browser SDK が HTTPS で JSON 形式のログを送信するために使用します。

サイトタイプエンドポイントポート説明
US1-FEDHTTPShttp-intake.logs.ddog-gov.com443HTTPS 経由で JSON またはプレーンテキスト形式のログを送信するためにカスタムフォワーダーが使用。Logs HTTP API のドキュメント参照。
US1-FEDHTTPSlambda-http-intake.logs.ddog-gov.datadoghq.com443HTTPS 経由で未加工、Syslog、または JSON 形式のログを送信するために Lambda 関数が使用。
US1-FEDHTTPSagent-http-intake.logs.ddog-gov.datadoghq.com443HTTPS 経由で JSON 形式のログを送信するために Agent が使用。ホスト Agent ログ収集のドキュメント参照。
US1-FEDHTTPSlogs.443Browser SDK が HTTPS で JSON 形式のログを送信するために使用します。

カスタムログ転送

TCP または HTTP 経由でログを転送できるカスタムプロセスまたはロギングライブラリを、Datadog ログと共に使用​​できます。

HTTP 経由で Datadog プラットフォームにログを送信できます。開始するには、Datadog ログ HTTP API ドキュメントを参照してください。

OpenSSL、GnuTLS、または他の SSL/TLS クライアントを使用して、接続を手動でテストすることができます。GnuTLS の場合は、以下のコマンドを実行します。

gnutls-cli intake.logs.datadoghq.com:10516

OpenSSL の場合、以下のコマンドを実行します。

openssl s_client -connect intake.logs.datadoghq.com:10516

ログエントリの前に必ず [Datadog API キー][1]を付けて、ペイロードを追加する必要があります。

<DATADOG_API_KEY> Log sent directly using TLS

ペイロード、または例で書かれている Log sent directly using TLS (TCP 経由で直接送信されたログ) は、raw、Syslog、または JSON 形式にすることができます。ペイロードが JSON 形式の場合、Datadog は自動的にその属性をパースします。

<DATADOG_API_KEY> {"message":"json formatted log", "ddtags":"env:my-env,user:my-user", "ddsource":"my-integration", "hostname":"my-hostname", "service":"my-service"}

[1]: /ja/account_management/api-app-keys/#api-keys

OpenSSL、GnuTLS、または他の SSL/TLS クライアントを使用して、手動で接続をテストすることができます。GnuTLS の場合は、以下のコマンドを実行します。

gnutls-cli tcp-intake.logs.datadoghq.eu:443

OpenSSL の場合、以下のコマンドを実行します。

openssl s_client -connect tcp-intake.logs.datadoghq.eu:443

ログエントリの前に必ず Datadog API キーを付けて、ペイロードを追加する必要があります。

<DATADOG_API_KEY> Log sent directly using TLS

ペイロード、または例で書かれている Log sent directly using TLS (TCP 経由で直接送信されたログ) は、raw、Syslog、または JSON 形式にすることができます。ペイロードが JSON 形式の場合、Datadog は自動的にその属性をパースします。

<DATADOG_API_KEY> {"message":"json formatted log", "ddtags":"env:my-env,user:my-user", "ddsource":"my-integration", "hostname":"my-hostname", "service":"my-service"}

TCP エンドポイントは、このサイトでは推奨していません。詳しくはサポートにお問い合わせください。

このサイトでは、TCP エンドポイントはサポートされていません。

:

  • HTTPS API は、最大で 1MB のサイズのログをサポートします。ただし、最適なパフォーマンスには各ログが 25K バイトを超えないことをおすすめします。ログ作成に Datadog Agent を使用する場合、ログは 256kB (256000 バイト) に分割されるよう構成されています。
  • 1 つのログイベントが持つことができるタグは 100 個以下です。1 日あたり最大 1,000 万個の一意のタグに対して、各タグは 256 文字を超えてはなりません。
  • JSON 形式に変換されたログイベントが保持できる属性は 256 未満です。これらの各属性のキーは 50 文字未満、連続するネストのレベルは 20 未満、 それぞれの値は (ファセットに昇格した場合) 1024 文字未満となります。
  • ログイベントは、過去 18 時間までのタイムスタンプで送信可能です。

上の制限に準拠しないログイベントは、システムによって変換されるか、切り詰められます。または、所定のタイムレンジ外の場合はインデックス化されません。ただし、Datadog はユーザーデータを可能な限り維持するよう全力を尽くします。

属性とタグ

属性は、ログエクスプローラーでのフィルタリングと検索に使用されるログファセットを規定します。予約済み属性および標準属性のリストと、ログ属性とエイリアス設定を使用した命名規則のサポート方法については、専用の属性とエイリアス設定ドキュメントをご参照ください。

スタックトレースの属性

スタックトレースをログに記録するに当たっては、Datadog アプリケーション内に専用の UI 表示を持つ特別な属性があります。ロガー名、現在のスレッド、エラーの種類、スタックトレース自体などです。

パースされたスタックトレースの属性

この機能を使用するには、以下の属性名を使用します。

属性説明
logger.nameロガーの名前
logger.thread_name現在のスレッドの名前
error.stack実際のスタックトレース
error.messageスタックトレースに含まれるエラーメッセージ
error.kindエラーのタイプまたは「種類」(“Exception” や “OSError” など)

: インテグレーションパイプラインは、デフォルトのログライブラリパラメーターをこれらの属性に再マップし、スタックトレースをパースまたはトレースバックして、自動的に error.messageerror.kind を抽出しようとします。

詳しくは、ソースコードと属性ドキュメントをご覧ください。

次のステップ

ログが収集されて取り込まれると、ログエクスプローラーで利用できるようになります。ログエクスプローラーでは、ログのアラートを検索、強化、表示できます。ログエクスプローラーのドキュメントを参照してログデータの分析を開始するか、以下の追加のログ管理ドキュメントを参照してください。

ログエクスプローラーに表示されるログ

その他の参考資料


*Logging without Limits は Datadog, Inc. の商標です。