メインコンテンツへスキップ
AppDynamics（Cisco）APM プラットフォームを接続することで、CloudThinker エージェントがアプリケーション、ティア、ノード、ビジネストランザクションの一覧取得、パフォーマンスメトリクスの取得、監視対象環境全体のアクティブなヘルスルール違反とエラーイベントのレビューを行えるようになります。 AppDynamics は、Controller アカウントにスコープされた API クライアント（OAuth2 クライアントクレデンシャル）で認証します。この接続は読み取り専用です。エージェントは Controller REST API にクエリを実行しますが、AppDynamics リソースを変更することはありません。

​
前提条件

  • CloudThinker で監視したいアプリケーションを持つ AppDynamics Controller（SaaS またはオンプレミス）。
  • アカウント配下に作成された API クライアントと、そのクライアント名およびクライアントシークレット。
  • Controller URL とアカウント名。
API クライアントには読み取り専用ロールを付与してください。CloudThinker はアプリケーションのヘルス、メトリクス、違反、イベントを読み取るだけで、AppDynamics の設定を変更することはありません。

​
セットアップ

1

AppDynamics Controller を開く

管理者として AppDynamics Controller にサインインします。SaaS の場合は Controller URL が https://<account>.saas.appdynamics.com 形式、オンプレミスの場合は自社のホストになります。
2

API クライアントを作成する

Settings → Administration → API Clients に移動し、Create をクリックします。
  • Client Name: cloudthinker
  • Description: Read-only access for CloudThinker agents
  • Roles: CloudThinker で監視したいアプリケーションへのアクセス権を持つ読み取り専用ロールを割り当てる
生成されたクライアントシークレットを直ちにコピーしてください。一度しか表示されません。
3

アカウント名を確認する

アカウント名は Settings → License で確認するか、Controller URL のサブドメイン（例: https://myaccount.saas.appdynamics.com の myaccount）から取得できます。
4

CloudThinker で接続を追加する

Connections → AppDynamics に移動して以下を入力します。
  • Controller URL: Controller のベース URL
  • Account Name: AppDynamics アカウント名
  • Client Name: API クライアント名（例: cloudthinker@myaccount）
  • Client Secret: コピーしたシークレット
Connect をクリックします。CloudThinker が認証情報を検証し、Connected ステータスを表示します。
API クライアントを作成した直後にクライアントシークレットをコピーしてください。AppDynamics は一度しか表示しません。紛失した場合はシークレットを再生成する必要があります。

​
接続の詳細

フィールド説明例
APPD_CONTROLLER_URLAppDynamics Controller のベース URLhttps://myaccount.saas.appdynamics.com
APPD_ACCOUNT_NAMEAppDynamics アカウント名myaccount
APPD_CLIENT_NAMEAPI クライアント名cloudthinker@myaccount
APPD_CLIENT_SECRETAPI クライアントシークレット—
AppDynamics の OAuth2 クライアントクレデンシャル認証でアクセストークンを取得するには、4 つのフィールドすべてが必要です。Controller URL、アカウント、クライアント名、シークレットを揃えてください。

​
必要な権限

CloudThinker が監視するアプリケーションへのアクセス権を持つ読み取り専用ロールを API クライアントに割り当ててください。読み取りアクセスには、アプリケーション、ティア、ノード、ビジネストランザクション、メトリクス、ヘルスルール違反、イベントが含まれます。
最小権限の原則に従ってください。監視とトリアージには読み取り専用ロールで十分です。CloudThinker が使用するクライアントには設定・管理権限を付与しないでください。

​
エージェントの機能

接続後、エージェントは AppDynamics APM データへの読み取りアクセスを持ちます。
機能説明
検出環境の概要をまとめる — アプリケーション、ティア、ノード、最近のヘルスシグナル
アプリケーションヘルスアプリケーションを一覧表示し、ヘルスルール違反や低下したビジネストランザクションをフラグ付けする
違反トリアージ重大度順にアクティブなヘルスルール違反を一覧表示・調査する
メトリクスレビューアプリケーションとビジネストランザクションのレスポンスタイム、1 分あたりのコール数、エラーレートを取得する
イベント分析最近のエラーイベントを取得し、影響を受けるティア別に上位のエラータイプをまとめる

​
接続の確認

@alex run AppDynamics discovery and summarize applications, tiers, and any active Health Rule violations

​
プロンプト例

@alex list all AppDynamics applications and flag any with a Health Rule violation or degraded Business Transaction error rate
@alex list all active Health Rule violations across AppDynamics applications ordered by severity and #recommend remediation steps
@alex pull the average response time and error rate for the top business transactions in the checkout application over the last hour
大規模な環境では、エージェントが絞り込んだ結果を返せるよう、特定のアプリケーション名と短い時間ウィンドウでリクエストを限定してください。

​
トラブルシューティング

クライアント名またはシークレットが間違っているか、API クライアントに必要なロールがありません。Client Name と Client Secret を確認し、クライアントに読み取り専用ロールが割り当てられているか確認してから再接続してください。
CloudThinker から Controller URL にアクセスできません。Controller URL が正しくアクセス可能か確認し、オンプレミス Controller でインバウンド接続が許可されているか確認してください。
アカウント名が Controller と一致していません。Settings → License または Controller のサブドメインを確認し、APPD_ACCOUNT_NAME を更新してください。
API クライアントのロールにアプリケーションへのアクセス権がないか、アカウントに該当するデータがありません。ロールが対象アプリケーションへの読み取りアクセスを付与しているか確認し、既知のアプリケーション名で再試行してください。
範囲を限定しないアプリケーションまたはメトリクスクエリはデータが多すぎます。結果を絞り込むために特定のアプリケーション名と短い時間ウィンドウでリクエストを限定してください。

​
セキュリティ

  • 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
  • デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
  • 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
  • オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
  • HTTPS の Controller URL — 転送中の認証情報を保護するために、常に HTTPS の Controller URL を使用してください。
  • 専用 API クライアント — CloudThinker 専用のクライアントを作成することで、他の統合に影響を与えることなく独立して失効させることができます。

​
関連情報

https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/datadog.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=e8382167f2a1eb1e00971b5f4d703d48

Datadog 接続

APM、メトリクス、監視
https://mintcdn.com/cloudthinker/CGWam0VVP8R5KVLk/images/icons/signoz.svg?fit=max&auto=format&n=CGWam0VVP8R5KVLk&q=85&s=d08abadb07adcc41c8812b59483344e3

SigNoz 接続

トレース、メトリクス、ログを一か所で