GAEにDatadog APMを導入する #GAE

概要

Datadog版のAPMです。
Datadog APMを導入すると、APMとして機能はもちろんですが、
機械学習をベースとしたWatchdogという機能でアプリケーションレイヤとインフラレイヤのメトリクスを学習し、異常を自動検出してくれる機能も利用できるそうです。便利ですね。

ただし、GAEにDatadog APMを導入しようと思い、オフィシャルの手順を見ると情報がこれしかありません。。

これだけだと具体的に何をどう設定すれば良いか分からないため、導入した時の手順を残します。

流れ

GCEにDatadog Agentをインストール
datadog.yamlの設定変更
Firewallの設定
Trace送信先の設定

手順

1. GCEにDatadog Agentをインストール

説明にもあったようにGAE単体ではAPMの導入ができず、GCE等にDatadog Agentをインストールし、
そこのホストにトレースデータを送信するようにしないといけません。
流れとしては、GAE -> GCE(Datadog Agent) -> Datadog APM といったイメージでしょうか。

Agentのインストール方法は、Datadogのアカウントをお持ちの方であれば、
こちらの手順を参考にしてください。
OSごとにインストール方法が別れています。

2. datadog.yamlの設定変更

次に/etc/datadog/datadog.yamlを以下のように修正し、Datadog Agentを再起動します。
コメントアウトを外すだけです。


apm_config:
  enable: true
  receiver_port: 8126
  apm_non_local_traffic: true

他プラットホームのトレースデータを受ける場合は、apm_non_local_traffic: trueを設定します。
これは通常の構成ではローカルからtracerを受信するのに対して、
エージェントから見ると外部の環境からのtracerを受信する事になるためです。

3. Firewallの設定

さきほどの設定で8126ポートをレシーバーポートとして設定しました。
GCEの場合はFirewall設定で8126ポートへのアクセスを許可してあげる必要があります。
ネットワークタグを使って8126ポートを許可してあげると良いと思います。

4. Trace送信先の設定

次にTrace送信先を設定します。
Rubyを例にすると、Datadog Agentが起動しているGCEのIPアドレスとポート(8126)を設定します。
以下のサンプルコードの5行目で、環境変数から取得したホスト名をtraceの送信先として設定してます。
https://github.com/DataDog/trace-examples/blob/master/ruby/rails/config/initializers/datadog.rb#L5

詳細は、こちらのオフィシャルドキュメントを参考にしてください。
他の言語については、こちらを参照してください。

それでは良いDatadog Lifeを。