インテグレーション＠Datadog¶
はじめに¶
本サイトにつきまして、以下をご認識のほど宜しくお願いいたします。
01. メトリクスインテグレーション¶
メトリクスインテグレーションとは¶
言語/フレームワーク/ツールなどに関して、専用のメトリクスの元になるデータポイントを収集できるようになる。
アプリケーションとして使用される言語/フレームワークの場合、datadog エージェントがインテグレーション処理を持つため、仮想環境へのインストールは不要である。
Datedog エージェントが稼働する言語/フレームワーク/ツールを自動的に認識してくれる。
02. ログインテグレーション¶
ログインテグレーションとは¶
アプリケーション、ミドルウェア、クラウドインフラなどのログを収集しやすくなるインテグレーションパイプラインパッケージを提供する。
インテグレーションパイプラインパッケージ¶
ログの作成元に合わせて、プロセッサーのセットが組み込まれたパイプラインを提供してくれる。
03. 分散トレースインテグレーション¶
分散トレースインテグレーションとは¶
言語/フレームワーク/ツールなどに関して、専用の分散トレースを収集できるようになる。
アプリケーションとして使用される言語/フレームワークの場合、トレースエージェントがインテグレーション処理を持つため、仮想環境へのインストールは不要である。
04. AWSインテグレーション¶
セットアップ¶
▼ 共通の手順¶
AWS リソースが作成したメトリクス/ログ/分散トレースを Datadog へフォワーディングできるようにする。
(1)-
Datadog の AWS アカウントの登録画面で、CloudFormation による自動セットアップを選択する。
これにより、AWSコンソール画面に自動的に遷移する。CloudFormationのテンプレートを使用して、スタックを作成できる。
ほとんどのパラメーターはデフォルト値が設定されており、空欄部分 (APIキーなど) に値を入力する。
(2)-
CloudFormation を実行し、メトリクス/ログ/分散トレースをフォワーディングする Lambda や IAM ロールを作成する。
このIAMロール (
DatadogIntegrationRole) には、DatadogのIAMユーザー (464622532012) に委譲できるように、AWS STSの設定がなされている。Datadogの設定画面にアカウントIDとロール名を入力することにより、設定画完了する。
この時点で、ログと分散トレースは収集できており、可視化の手順のみが必要である。
一方で、ログは可視化が不要であるが、収集の手順が必要である。
▼ メトリクス、分散トレースの可視化¶
(1)-
共通の手順を参照。
(2)-
共通の手順を参照。
(3)-
収集したデータポイントを可視化できるように、各 AWS リソースのインテグレーションをインストールする。
インストール後、しばらく待つと、AWSインフラのメトリクスの元になるデータポイントや分散トレースが収集されていることを確認できる。
▼ ログの収集¶
(1)-
共通の手順を参照。
(2)-
共通の手順を参照。
(3)-
ログを収集できるように、Lambda のトリガーとして Amazon CloudWatch Logs や Amazon S3 を設定する。
トリガーとして設定せずに自動的にも収集できるが、自動認識されるログの種類が少ないので、手動で設定したほうが良い。
(4)-
トリガーとする AWS リソースの命名によって、ログの
service属性の値が変わる。例えば、Amazon CloudWatch Logsのロググループ名が『
api-gateway-*****』から始まる場合、service属性の値はapigatewayになる。
料金¶
Amazon EC2、Amazon ECS、Lambda で料金が発生し、それ以外の AWS リソースは無料である。
05. PHP-FPMインテグレーション¶
PHP-FPM インテグレーションをインストールした場合、収集したデータポイントを可視化できるようになる。
ログはサポートしていない。
06. Nginxインテグレーション¶
Nginx インテグレーションをインストールした場合、収集したログとメトリクスを可視化できるようになる。