> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudthinker.io/llms.txt
> Use this file to discover all available pages before exploring further.

# AppDynamics

> CloudThinker と AppDynamics（Cisco）APM を接続して、アプリケーションヘルス監視、ヘルスルール違反のトリアージ、メトリクスレビューを実現する

AppDynamics（Cisco）APM プラットフォームを接続することで、CloudThinker エージェントがアプリケーション、ティア、ノード、ビジネストランザクションの一覧取得、パフォーマンスメトリクスの取得、監視対象環境全体のアクティブなヘルスルール違反とエラーイベントのレビューを行えるようになります。

AppDynamics は、Controller アカウントにスコープされた **API クライアント**（OAuth2 クライアントクレデンシャル）で認証します。この接続は読み取り専用です。エージェントは Controller REST API にクエリを実行しますが、AppDynamics リソースを変更することはありません。

***

## 前提条件

* CloudThinker で監視したいアプリケーションを持つ **AppDynamics Controller**（SaaS またはオンプレミス）。
* アカウント配下に作成された **API クライアント**と、その**クライアント名**および**クライアントシークレット**。
* **Controller URL** と**アカウント名**。

<Info>
  API クライアントには読み取り専用ロールを付与してください。CloudThinker はアプリケーションのヘルス、メトリクス、違反、イベントを読み取るだけで、AppDynamics の設定を変更することはありません。
</Info>

***

## セットアップ

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

  <Step title="API クライアントを作成する">
    **Settings → Administration → API Clients** に移動し、**Create** をクリックします。

    * **Client Name**: `cloudthinker`
    * **Description**: `Read-only access for CloudThinker agents`
    * **Roles**: CloudThinker で監視したいアプリケーションへのアクセス権を持つ読み取り専用ロールを割り当てる

    生成された**クライアントシークレット**を直ちにコピーしてください。一度しか表示されません。
  </Step>

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

  <Step title="CloudThinker で接続を追加する">
    **Connections → AppDynamics** に移動して以下を入力します。

    * **Controller URL**: Controller のベース URL
    * **Account Name**: AppDynamics アカウント名
    * **Client Name**: API クライアント名（例: `cloudthinker@myaccount`）
    * **Client Secret**: コピーしたシークレット

    **Connect** をクリックします。CloudThinker が認証情報を検証し、**Connected** ステータスを表示します。
  </Step>
</Steps>

<Warning>
  API クライアントを作成した直後にクライアントシークレットをコピーしてください。AppDynamics は一度しか表示しません。紛失した場合はシークレットを再生成する必要があります。
</Warning>

***

## 接続の詳細

| フィールド                     | 説明                              | 例                                        |
| ------------------------- | ------------------------------- | ---------------------------------------- |
| **APPD\_CONTROLLER\_URL** | AppDynamics Controller のベース URL | `https://myaccount.saas.appdynamics.com` |
| **APPD\_ACCOUNT\_NAME**   | AppDynamics アカウント名              | `myaccount`                              |
| **APPD\_CLIENT\_NAME**    | API クライアント名                     | `cloudthinker@myaccount`                 |
| **APPD\_CLIENT\_SECRET**  | API クライアントシークレット                | —                                        |

<Note>
  AppDynamics の OAuth2 クライアントクレデンシャル認証でアクセストークンを取得するには、4 つのフィールドすべてが必要です。Controller URL、アカウント、クライアント名、シークレットを揃えてください。
</Note>

***

## 必要な権限

CloudThinker が監視するアプリケーションへのアクセス権を持つ**読み取り専用ロール**を API クライアントに割り当ててください。読み取りアクセスには、アプリケーション、ティア、ノード、ビジネストランザクション、メトリクス、ヘルスルール違反、イベントが含まれます。

<Tip>
  最小権限の原則に従ってください。監視とトリアージには読み取り専用ロールで十分です。CloudThinker が使用するクライアントには設定・管理権限を付与しないでください。
</Tip>

***

## エージェントの機能

接続後、エージェントは AppDynamics APM データへの読み取りアクセスを持ちます。

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

### 接続の確認

```text theme={null}
@alex run AppDynamics discovery and summarize applications, tiers, and any active Health Rule violations
```

### プロンプト例

```text theme={null}
@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
```

大規模な環境では、エージェントが絞り込んだ結果を返せるよう、特定のアプリケーション名と短い時間ウィンドウでリクエストを限定してください。

***

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

<Accordion title="401 または 403 Unauthorized">
  クライアント名またはシークレットが間違っているか、API クライアントに必要なロールがありません。**Client Name** と **Client Secret** を確認し、クライアントに読み取り専用ロールが割り当てられているか確認してから再接続してください。
</Accordion>

<Accordion title="接続拒否またはタイムアウト">
  CloudThinker から Controller URL にアクセスできません。**Controller URL** が正しくアクセス可能か確認し、オンプレミス Controller でインバウンド接続が許可されているか確認してください。
</Accordion>

<Accordion title="アカウントが見つからない">
  アカウント名が Controller と一致していません。**Settings → License** または Controller のサブドメインを確認し、**APPD\_ACCOUNT\_NAME** を更新してください。
</Accordion>

<Accordion title="アプリケーションまたはメトリクスが見つからない">
  API クライアントのロールにアプリケーションへのアクセス権がないか、アカウントに該当するデータがありません。ロールが対象アプリケーションへの読み取りアクセスを付与しているか確認し、既知のアプリケーション名で再試行してください。
</Accordion>

<Accordion title="出力が大きい、またはノイズが多い">
  範囲を限定しないアプリケーションまたはメトリクスクエリはデータが多すぎます。結果を絞り込むために特定のアプリケーション名と短い時間ウィンドウでリクエストを限定してください。
</Accordion>

***

## セキュリティ

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

- **HTTPS の Controller URL** — 転送中の認証情報を保護するために、常に HTTPS の Controller URL を使用してください。
- **専用 API クライアント** — CloudThinker 専用のクライアントを作成することで、他の統合に影響を与えることなく独立して失効させることができます。

***

## 関連情報

<CardGroup cols={2}>
  <Card title="Datadog 接続" icon="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" href="/ja/guide/connections/datadog" width="24" height="24" data-path="images/icons/datadog.svg">
    APM、メトリクス、監視
  </Card>

  <Card title="SigNoz 接続" icon="https://mintcdn.com/cloudthinker/CGWam0VVP8R5KVLk/images/icons/signoz.svg?fit=max&auto=format&n=CGWam0VVP8R5KVLk&q=85&s=d08abadb07adcc41c8812b59483344e3" href="/ja/guide/connections/signoz" width="24" height="24" data-path="images/icons/signoz.svg">
    トレース、メトリクス、ログを一か所で
  </Card>
</CardGroup>