Agent フレア

Agent Flare の送信はこのサイトではサポートされていません。

フレアを使用すると、必要なトラブルシューティング情報を Datadog のサポートチームに送信できます。

このページでは、以下の内容を説明しています。

フレアは、Agent のすべてのコンフィギュレーションファイルとログをアーカイブファイルに収集し、パスワード、API キー、プロキシ認証情報、SNMP コミュニティ文字列などの機密情報を削除します。また、APM が有効な場合、利用可能であればトレーサーデバッグログも含まれます。

Datadog Agent は完全にオープンソースなので、コードの動作を検証することができます。フレアは、アップロードの前に確認を求めるため、必要に応じて送信前にフレアを確認できます。

Datadog サイトからフレアを送信する

Datadog サイトからフレアを送信するには、Agent の Fleet Automation と Remote configuration が有効になっていることを確認してください。

To send a remote flare:

  1. From the Fleet Automation page, select an Agent that requires support.
  2. Click Support.
  3. Click Send Support Ticket.
  4. Provide an existing Zendesk support ticket number. If you don’t provide a ticket number, one is created on your behalf.
  5. Enable Debug mode to allow Datadog support staff to troubleshoot your issue faster. The log level is reset to its previous configuration after you send the flare.
  6. If you are troubleshooting your application, enable application tracer level logs to be included in the flare.
  7. Click Send Ticket.
Send Ticket ボタンは、既存または新規のサポートチケットに対してフレアを送信するためのフォームを起動します

flare コマンドを使用してフレアを送信する

flare サブコマンドを使用してフレアを送信します。以下のコマンドで、<CASE_ID> を実際の Datadog サポートケース ID (ある場合) に置き換え、それに紐づけされているメールアドレスを入力します。

ケース ID がない場合は、Datadog へのログインに使用するメールアドレスを入力して新しいサポートケースを作成します。

アーカイブのアップロードを確認し、直ちに Datadog サポートに送信してください。

    プラットフォームコマンド
    AIXdatadog-agent flare <CASE_ID>
    Dockerdocker exec -it dd-agent agent flare <CASE_ID>
    macOSdatadog-agent flare <CASE_ID> または Web GUI を使用
    CentOSsudo datadog-agent flare <CASE_ID>
    Debiansudo datadog-agent flare <CASE_ID>
    Kuberneteskubectl exec -it <AGENT_POD_NAME> -- agent flare <CASE_ID>
    Fedorasudo datadog-agent flare <CASE_ID>
    Redhatsudo datadog-agent flare <CASE_ID>
    Susesudo datadog-agent flare <CASE_ID>
    ソースsudo datadog-agent flare <CASE_ID>
    WindowsWindowsに関する個別のドキュメントをご参照ください。
    HerokuHerokuに関する個別のドキュメントをご参照ください。
    PCFsudo /var/vcap/jobs/dd-agent/packages/dd-agent/bin/agent/agent flare <CASE_ID>

    専用コンテナ

    Agent v7.19 以降を使用し、Datadog Helm Chart を最新バージョンで使用するか、Datadog Agent と Trace Agent が別々のコンテナにある DaemonSet を使用する場合は、以下を含む Agent Pod をデプロイします。

    • Agent プロセスを含む 1 つのコンテナ (Agent + Log Agent)
    • process-agent プロセスを含む 1 つのコンテナ
    • trace-agent プロセスを含む 1 つのコンテナ
    • system-probe プロセスを含む 1 つのコンテナ

    各コンテナからフレアを取得するには、次のコマンドを実行します。

    Agent

    kubectl exec -it <AGENT_POD_NAME> -c agent -- agent flare <CASE_ID>

    プロセスエージェント

    kubectl exec -it <AGENT_POD_NAME> -c process-agent -- agent flare <CASE_ID> --local

    トレースエージェント

    kubectl exec -it <AGENT_POD_NAME> -c trace-agent -- agent flare <CASE_ID> --local

    Security Agent

    kubectl exec -it <AGENT_POD_NAME> -c security-agent -- security-agent flare <CASE_ID>

    システムプローブ

    system-probe コンテナはフレアを送信できないため、代わりにコンテナログを取得します:

    kubectl logs <AGENT_POD_NAME> -c system-probe > system-probe.log

    ECS Fargate

    ECS Fargate プラットフォーム v1.4.0 を使用する場合、Amazon ECS Exec を有効にすることで、実行中の Linux コンテナへのアクセスを許可するように ECS タスクとサービスを構成できます。Amazon ECS Exec を有効にした後、次のコマンドを実行してフレアを送信します。

    aws ecs execute-command --cluster <CLUSTER_NAME> \
    --task <TASK_ID> \
    --container datadog-agent \
    --interactive \
    --command "agent flare <CASE_ID>"

    注: ECS Exec は、新しいタスクに対してのみ有効にできます。ECS Exec を使用するには、既存のタスクを再作成する必要があります。

    プラットフォームコマンド
    Kuberneteskubectl exec -n <NAMESPACE> -it <CLUSTER_POD_NAME> -- datadog-cluster-agent flare <CASE_ID>
    Cloud Foundry/var/vcap/packages/datadog-cluster-agent/datadog-cluster-agent-cloudfoundry flare -c /var/vcap/jobs/datadog-cluster-agent/config <CASE_ID>

    手動送信

    Agent フレアプロトコルは、コンフィギュレーションとログをまずローカルの /tmp ディレクトリにあるアーカイブファイルに収集します。 Agent のデータ収集に問題がある場合は、このファイルを手動で取得してサポートに送信してください。

    Kubernetes

    Kubernetes でアーカイブファイルを取得するには、kubectl コマンドを使用します。

    kubectl cp datadog-<pod-name>:tmp/datadog-agent-<date-of-the-flare>.zip flare.zip -c agent

    その他の参考資料

    お役に立つドキュメント、リンクや記事:

    Agent デバッグモードドキュメント more more Agent チェックのステータスを確認ドキュメント more more