This product is not supported for your selected Datadog site. ().

エージェントを使用して RUM をセットアップしてください

Copy this prompt into your AI coding agent to use the dd-orchestrator skill for guided RUM setup.
https://github.com/datadog-labs/agent-skills/blob/main/dd-orchestrator/SKILL.md のスキルを使用して、プロジェクトに Datadog RUM をセットアップしてください

概要

エージェントによるオンボーディングは、アプリケーションとインフラストラクチャーの Datadog インスツルメンテーションを自動化する AI 駆動型ツールセットです。

  • AI Setup CLI: コーディングアシスタントを使用せずに、ターミナルから Datadog をセットアップします。
  • Datadog MCP Server: コーディングアシスタント (Claude Code や Cursor など) を介して Datadog をセットアップします。IDE からフレームワークの検出と構成を処理します。

これら 2 つのパスは補完的なものであり、同じ Datadog アカウントを使用します。IDE で Datadog MCP Server をインストールし、ターミナルで CLI を実行できます。

AI Setup CLI

Datadog AI Setup CLI は、スタンドアロンのターミナルツールです。MCP Server をインストールしたくない場合や、Datadog アカウントの作成など、MCP セットアップがサポートしていないタスクを実行する場合に使用します。

CLI では以下が可能です。

  • ターミナルから Datadog アカウントをエンドツーエンドで作成する
  • 既存の Datadog アカウントをローカル環境にリンクする
  • ファイルを直接編集してローカル Infrastructure as Code (Terraform、Helm、Kustomize、Ansible、Pulumi、生の Kubernetes マニフェスト、Docker Compose ファイル) をインスツルメントする
  • サポートされているフロントエンドおよびバックエンドの SDK 初期化および構成を追加して、ローカルのアプリケーションコードをインスツルメントする

前提条件

  • Node.js 22 以降

対応製品

CLI では以下の製品をセットアップできます。

製品識別子
App and API Protectionapp_and_api_protection
Code Coverageci_code_coverage
Dockerdocker
Error Trackingerror-tracking
Infrastructure Monitoringinfra-monitoring
Linuxlinux
Agent Observabilityllm-obs
OpenTelemetryotel
Product Analyticsproduct-analytics
Real User Monitoring (RUM)rum
Serverless Monitoringserverless
Studiostudio
Test Optimizationtest-optimization

CLI をインストールして実行する

npx を使用して CLI を実行し、--siteを渡して Datadog サイトをターゲットにします ()。Datadog アカウントをすでに持っているかどうかに応じて 2 つのオプションがあります。

  1. Datadog アカウントを持っていない場合、またはコード分析に基づいて CLI に製品を推奨してもらいたい場合は、このオプションを使用します。CLI が、アカウントのセットアップ、リポジトリの分析、製品の推奨手順を案内します。

    npx @datadog/ai-setup-cli --site datadoghq.com
    

    --site の値をアカウントの Datadog サイトに置き換えます ()。

  2. ウェルカム画面で Enter を押し、Datadog アカウントを持っているかどうかを選択します。OAuth (またはまだアカウントを持っていない場合はアカウントの作成) 用にブラウザが開きます。フローを完了し、Datadog アカウントへのアクセスを許可してください。

  3. インスツルメントするリポジトリへのパスを入力します。

  4. 同意すると、CLI は読み取り専用モードでリポジトリを分析し、スタックを検出します。

  5. 検出されたスタックに基づいて、CLI は対応している Datadog プロダクトを最大で 3 つ推奨します。推奨事項はデフォルトで選択されています。個別の推奨事項の選択を解除するか、選択内容を確認するか、またはすべてのセットアップオプションを表示するを選択して、代わりにセットアップオプションの全リストを使用します。

  1. Datadog アカウントをすでに持っていて、インストールする製品が決まっている場合は、このオプションを使用します。--product フラグを追加すると、リポジトリ分析と製品の推奨事項をスキップして、直接セットアップに進むことができます。

    npx @datadog/ai-setup-cli --site datadoghq.com --product <PRODUCT>
    
    • --site の値をアカウントの Datadog サイトに置き換えます ()。
    • 対応製品セクションに記載されている製品のいずれかに <PRODUCT> を置き換えます。
  2. ウェルカム画面で Enter を押し、Datadog アカウントを持っているかどうかを選択します。OAuth (またはまだアカウントを持っていない場合はアカウントの作成) 用にブラウザが開きます。フローを完了し、Datadog アカウントへのアクセスを許可してください。

セットアップを構成して検証する

  1. CLI が推奨事項を生成できない場合、または高い精度で一致するものがリポジトリに見つからない場合は、セットアップオプションの全リストが表示されます。--product による直接セットアップでは、このメニューから開始します。

    CLI メニュー「What would you like to set up?」は、インフラストラクチャーおよびバックエンドモニタリング、フロントエンドモニタリング、LLM ベースのアプリケーション、および CI テストごとにグループ化されています。

  2. CLI はプロジェクトのフレームワークを検出し、必要な構成を適用し、必要な環境変数をプロビジョニングします。進捗状況が段階的に報告されます。

    進捗ステップで「Instrumenting your app, Stage 1 of 3: Datadog RUM (Real User Monitoring)」と表示された CLI。

  3. セットアップが完了すると、CLI はインスツルメントした製品を表示し、受信データを確認するために Datadog UI にリンクします。

  4. 変更内容をリポジトリにコミットします。特定の環境に合わせて Datadog の環境変数 (API キー、アプリケーション ID) を編集できます。

CLI が完了したら、次のステップセクションを参照して、データが流れていることを確認してください。

ヘッドレスモード

ヘッドレスモードは、無人セットアップ用に設計されています。AI コーディングエージェント、CI ジョブ、またはスクリプトは、リポジトリで直接 CLI を実行し、Datadog インスツルメンテーションを自動的に完了させることができます。プロンプトの承認や対話形式の選択を行うために、人が立ち会う必要はありません。

--headless を使用して、対話型 UI をスキップします。これには --site と --product の両方が必要です。

DD_API_KEY=<API_KEY> DD_APP_KEY=<APP_KEY> \
  npx @datadog/ai-setup-cli \
  --headless \
  --site datadoghq.com \
  --product rum

ユーザーの操作なしで認証を行うには、DD_API_KEY と DD_APP_KEY の環境変数を設定します。両方の変数を一緒に指定してください。

あるいは、API キーとアプリケーションキーを省略して、ブラウザの OAuth で認証することも可能です。OAuth はヘッドレスの実行においてユーザーの操作が必要となる可能性のある唯一の部分であり、ローカルホストのコールバックが必要です。リモート環境や完全に無人の環境では、代わりに DD_API_KEY と DD_APP_KEY の環境変数を使用してください。

--headless を使用することで、ソースコードのアップロードと自動コマンド実行が対象プロジェクトに対して許可されていることを確認したことになります。

MCP Server

Datadog MCP Server は、MCP 互換のコーディングアシスタントに対して onboarding ツールセットを公開します。サーバーのインストールと認証が完了したら、1 行のプロンプトを入力してプロジェクトをインスツルメントします。エージェントはコードを読み取り、(許可を得て) MCP ツールを呼び出し、変更を適用し、結果を検証します。

前提条件

  • Claude Code や Cursor などの MCP 対応コーディングアシスタント
  • Datadog アカウント

対応フレームワーク

製品フレームワーク
Error Tracking、RUM、Product AnalyticsAndroid、Angular、iOS、Next.js、React、Svelte、Vanilla JS、Vue
Kubernetes ObservabilityHelm、Kustomize、raw manifests、Terraform、Pulumi、Ansible (GKE、EKS、AKS、minikube、および kind、k3s、OpenShift など)
Docker Observabilitydocker-compose およびサイドカー (docker run) デプロイメント。Terraform、Ansible、およびその他の IaC (Pulumi、CloudFormation、Puppet、Chef)
Linux ObservabilityTerraform、Ansible、その他の IaC (Pulumi、CloudFormation、Puppet、Chef)、および plain-shell install
Serverless Monitoring (AWS Lambda)AWS SAM、AWS CDK、Serverless Framework、Terraform、datadog-ci lambda instrument
Serverless Monitoring (GCP Cloud Run および Cloud Run Functions)Terraform、gcloud run deploy、Cloud Run YAML、Dockerfile、Gen 2 gcloud functions deploy
Serverless Monitoring (Azure Container Apps)Terraform、Bicep、ARM テンプレート、azure.yaml (azd)、az containerapp CLI
Agent ObservabilityOpenAI、Anthropic、LangChain、Vercel AI SDK (プロジェクトの依存関係から自動検出)
OpenTelemetryNode.js / サーバーサイド TS、Browser JS / React / Vite、Python (Django、Flask、FastAPI)、Java、Go
App and API ProtectionPython、Node.js、Java、Go、Ruby、.NET、PHP、および Linux、Windows、Kubernetes、Docker、GCP Cloud Run、AWS Lambda、AWS Fargate/ECS 用のプロキシ (Envoy、HAProxy)
Code Coverage, Test OptimizationJest、Vitest、Mocha、Playwright、Cypress、pytest、unittest、JUnit、TestNG、RSpec、minitest、xUnit、NUnit、MSTest v2、go test、XCTest / Swift Testing

ステップ 1: MCP Server をインストールする

アクティブな Claude Code セッションで、以下を実行します。

claude mcp add --transport http datadog-onboarding- "?toolsets=onboarding"

オプション 1: ディープリンクをインストールする (推奨)

使用している Datadog サイトのインストールディープリンクをクリックし、カーソルが開いたら datadog-onboarding- サーバーの Installを確認します。

オプション 2: 手動構成

~/.cursor/mcp.json にサーバーを追加します。

{
  "mcpServers": {
    "datadog-onboarding-": {
      "url": "?toolsets=onboarding"
    }
  }
}

HTTP トランスポートをサポートする MCP クライアントは、Datadog MCP Server に接続できます。Datadog サイトのエンドポイントでそれを指定します。

?toolsets=onboarding

ステップ 2: MCP Server を認証する

  1. MCP Server をインストールすると、コーディングアシスタントが認証を求めてきます。Enter を押して、ブラウザで Datadog OAuth 画面を開きます。
  2. 認証が完了したら、Open を選択して IDE に戻り、MCP Server に Datadog アカウントへのアクセス権を付与します。
  3. MCP ツールが `datadog-onboarding- サーバーの下に表示されることを確認します。

ステップ 3: プロジェクトをインスツルメントする

セットアップする製品に一致するプロンプトを送信します。

Add Datadog Error Tracking to my project
Add Datadog Real User Monitoring to my project
Add Datadog Product Analytics to my project

Kubernetes

Add Datadog for Kubernetes to my project

Docker

Add Datadog for Docker to my project
Add Datadog App and API Protection to my project

AWS Lambda

Add Datadog for AWS Lambda to my project
npx @datadog/ai-setup-cli --product serverless --serverless-compute-type=aws-lambda

GCP Cloud Run コンテナ

Add Datadog for GCP Cloud Run containers to my project
npx @datadog/ai-setup-cli --product serverless --serverless-compute-type=gcp-cloud-run

GCP Cloud Run 関数

Add Datadog for GCP Cloud Run functions to my project
npx @datadog/ai-setup-cli --product serverless --serverless-compute-type=gcp-cloud-run-functions

Azure Container Apps

Add Datadog for Azure Container Apps to my project
npx @datadog/ai-setup-cli --product serverless --serverless-compute-type=azure-container-apps

エージェントがスタックを検出し、ツール呼び出しのたびに許可を求め、変更をローカルに適用し (コミットは行いません)、検証手順を出力します。

エージェントの完了後、変更をリポジトリにコミットし、新しい環境変数 (API キー、アプリケーション ID) を本番環境に設定します。その後、次のステップセクションを参照して、データが流れていることを確認してください。

次のステップ

セットアップした製品について、Datadog UI でデータが流れていることを確認してください。

参考資料