こんにちは。オブザーバビリティの世界へようこそ。
「システムがなぜか重い」「どこでエラーが起きているかわからない」。そんな暗闇で手探りをするような運用から抜け出し、システムの中身をレントゲン撮影のように可視化する。それがオブザーバビリティの真髄です。
今回は、その第一歩としてDatadog Agentの導入を解説します。ただインストールするだけならマニュアル通りで済みますが、ここでは「なぜそれが必要なのか」という本質を交えながら、現場で即戦力となるセットアップ手順を伝授します。
—
1. なぜ「Agent」が必要なのか？
DatadogはSaaSですが、監視対象のサーバーに「Datadog Agent」という小さなプログラムを常駐させる必要があります。
- メトリクスの収集: CPU使用率、メモリ、ディスクI/Oなどを定期的に吸い上げる。
- ログの転送: ファイルに書き出されたログをリアルタイムでDatadogへ飛ばす。
- APM（分散トレーシング）: アプリケーション内部の関数呼び出しやDBクエリの時間を計測する。
これらが一つのAgentに統合されているのがDatadogの強みです。さあ、あなたのサーバーに「目」をつけましょう。
—
2. インストール手順（Ubuntu編）
まずはDatadogのコンソールにログインし、`Integrations` > `Agent` からUbuntuを選択してください。そこで表示されるAPIキーは、あなたのサーバーとDatadogを紐づける唯一の鍵です。
手順①：エージェントのインストール
ターミナルを開き、以下のコマンドを順番に実行します。
1. パッケージリストの更新と必要なツールのインストール
sudo apt-get update && sudo apt-get install -y curl
2. Datadogの公式インストールスクリプトを実行
DD_API_KEY には、あなたのダッシュボードで発行されたキーを入れてください
DD_API_KEY=<あなたのAPIキー> DD_SITE=”datadoghq.com” bash -c “$(curl -L https://s3.amazonaws.com/dd-agent/scripts/install_script_agent7.sh)”
【プロの視点】
`DD_SITE` は非常に重要です。Datadogのデータセンターの場所を指定します。日本リージョンを使っている場合は `datadoghq.com` か、設定により `datadoghq.eu` などが異なる場合があります。ここを間違えると、データが迷子になります。
—
3. 初期セットアップと疎通確認
インストールが終わったら、Agentが正しく動いているか、そして外部と通信できているかを確認します。
ステータス確認コマンド
Agentが元気に動いているか確認
sudo datadog-agent status
このコマンドを打つと、長いログが出力されます。注目すべきは `Checks` というセクションです。ここで `cpu`, `memory`, `disk` などが `OK` になっていれば、基礎的な監視は成功です。
疎通テスト（重要）
万が一、グラフが上がってこない場合はファイアウォール（iptables/ufw）やネットワーク環境を疑います。以下のコマンドで疎通確認が可能です。
DatadogのAPIエンドポイントへ疎通テスト
成功すると、200 OKや何らかのレスポンスが返ってきます
curl -v https://app.datadoghq.com/
—
4. 現場で役立つ「設定ファイル」の覗き方
Agentの設定は、`/etc/datadog-agent/datadog.yaml` に集約されています。
/etc/datadog-agent/datadog.yaml
本来はデフォルトでOKですが、サーバーに名前をつけたい時はここを変えます
hostname: my-production-web-server-01
ログ収集を有効にするには、以下をtrueにします
logs_enabled: true
設定を変更した後は、必ず再起動を忘れないでください。
`sudo systemctl restart datadog-agent`
—
5. 最後に：ここからがオブザーバビリティの始まり
これであなたのサーバーは、Datadogという「強力な相棒」と繋がりました。
インストールが終わったら、まずはDatadogのダッシュボードを見てみてください。「Host Map」や「Infrastructure List」にあなたのサーバーが緑色の丸で表示されているはずです。その丸をクリックした瞬間、今まで見えなかったシステムの鼓動（メトリクス）が可視化されていることに感動するはずです。
次へのステップ:
次は「ログの監視」や「APMの導入」に挑戦してみてください。メトリクスで「異常」を検知し、ログで「詳細」を追い、APMで「ボトルネック（原因）」を特定する。これができるようになった時、あなたはもう初心者ではありません。
運用監視は「守り」の作業ですが、オブザーバビリティは「攻め」の武器です。この武器を使いこなし、自信を持ってシステムを運用してください。応援していますよ！