> ## 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.

# New Relic

> New Relic MCPサーバー経由でNew RelicをCloudThinkerに接続し、APM・インフラストラクチャ監視・NRQLクエリ・アラート・インシデント調査を行います

New Relicアカウントを接続することで、CloudThinkerエージェントがアプリケーションパフォーマンスの監視、インフラストラクチャの検査、NRQLクエリの実行、アラートの確認、オブザーバビリティスタック全体でのインシデント調査を行えるようになります。

New Relicは**ユーザーAPIキー**（`NRAK-…`）で認証し、**New Relic AI MCPサーバー**を通じて接続します。接続前にこのMCPサーバーを有効にする必要があります。

***

## 対応リージョン

| リージョン  | MCPエンドポイント            |
| ------ | --------------------- |
| **US** | `mcp.newrelic.com`    |
| **EU** | `mcp.eu.newrelic.com` |

<Warning>
  アカウントに合ったリージョンを選択してください。EUアカウントをUSリージョンで接続した場合（またはその逆）、認証が失敗するか空の結果が返されます。
</Warning>

***

## 前提条件

**New Relic AI MCPサーバー**の有効化と**ユーザーAPIキー**（`NRAK-…`）が必要です。

**New Relic AI MCPサーバーを有効化:**

CloudThinkerはNew Relic AI MCPサーバーを通じてNew Relicに接続します。このMCPサーバーはパブリックプレビュー中であり、接続前に有効にする必要があります。FedRAMPまたはHIPAA管理下のアカウントでの使用は、New Relicの利用規約により厳しく禁止されています。

1. New Relicで左下隅の**ユーザー名**をクリックします。
2. **Administration → Previews & Trials** に移動します。
3. **New Relic AI MCP server** のプレビュートグルを有効にします。

**ユーザーAPIキーの作成:**

1. **API keys**（ユーザーメニュー → **API keys**、または `one.newrelic.com/api-keys`、EU: `one.eu.newrelic.com/api-keys`）を開きます。
2. **Create a key** をクリックし、**Key type** を **User** に設定します。
3. 名前（例: `CloudThinker`）を付けて保存します。
4. キーの値をコピーします。完全な `NRAK-…` キーは作成時に**一度だけ**表示されます。

<Warning>
  **ユーザーAPIキー**（`NRAK-…`）を使用してください。ライセンスキー、インジェストキー、クエリキーはデータ取り込み用であり、クエリには機能しません。これは最も一般的な設定ミスです。
</Warning>

***

## セットアップ

<Steps>
  <Step title="CloudThinkerを開く">
    CloudThinkerワークスペースで **Connections → New Relic** に移動し、**Connect New Relic** をクリックします。
  </Step>

  <Step title="接続名を設定">
    **Alias**（このインスタンスの一意の識別子、例: `production`）と**Description**を入力します。
  </Step>

  <Step title="APIキーを入力">
    New Relic **ユーザーAPIキー**（`NRAK-…`）を貼り付けます。
  </Step>

  <Step title="リージョンを選択">
    New Relicアカウントに合ったリージョン **US**（`mcp.newrelic.com`）または **EU**（`mcp.eu.newrelic.com`）を選択します。
  </Step>

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

***

## 接続の詳細

| フィールド                  | 説明                                       | 例                           |
| ---------------------- | ---------------------------------------- | --------------------------- |
| **NEWRELIC\_API\_KEY** | New RelicユーザーのユーザーAPIキー（`NRAK-` プレフィックス） | `NRAK-XXXXXXXXXXXXXXXXXXXX` |
| **NEWRELIC\_REGION**   | アカウントに合ったリージョン                           | `US` / `EU`                 |

***

## 必要な権限

ユーザーAPIキーは、所属するユーザーの権限を継承します。最小権限の原則に従うため、そのユーザーを読み取り専用アクセスにスコープしてください。

<Tip>
  MCPサーバーアクセスのため、キーのユーザーは **Organization Read Only**、**Organization Manager**、**Organization Product Admin** が割り当てられたグループ、またはMCPの読み取り権限を付与するカスタムロールに属している必要があります。最小権限には **Organization Read Only** を使用してください。NRQLとNerdGraphクエリには読み取り専用ロールで十分です。
</Tip>

***

## エージェント機能

接続後、エージェントはNew Relic環境全体でクエリと調査を行えます。

| 機能              | エージェントができること                                    |
| --------------- | ----------------------------------------------- |
| **APM**         | アプリケーションパフォーマンスの検査 — スループット、エラーレート、トランザクショントレース |
| **インフラストラクチャー** | ホストとコンテナの一覧表示、リソース使用率の確認                        |
| **NRQL**        | NerdGraph経由で任意のテレメトリに対してNRQLクエリを実行              |
| **アラート**        | アラートポリシー、条件、オープンバイオレーションを確認                     |
| **ログ**          | サービスと環境をまたいでログを検索・分析                            |
| **エンティティ**      | 監視されているエンティティとサービスを探索・検査                        |
| **インシデント**      | オープンなイシューを調査し、完全なインシデント詳細を取得                    |
| **ダッシュボード**     | ダッシュボード設定を検査                                    |
| **接続ヘルス**       | New Relic接続が正常に動作しているか確認                        |

### 接続を確認

```text theme={null}
@alex verify the New Relic connection and list monitored entity types and any open alert violations
```

### プロンプト例

```text theme={null}
@alex check error rates for the checkout service in New Relic over the last hour
@alex run an NRQL query for the slowest transactions in the production app
@alex list open New Relic alert violations and investigate the root cause
```

***

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

<Accordion title="接続が失敗または認証エラー">
  ライセンスキー、インジェストキー、クエリキーではなく、**ユーザーAPIキー**（`NRAK-…`）を使用していることを確認してください。New Relicでキーが削除またはローテーションされていないこと、キーのユーザーがアカウントへのアクセス権を持っていることを確認してください。
</Accordion>

<Accordion title="結果が空または認証失敗">
  選択したリージョンがアカウントと一致しているか確認してください。EUアカウントはEUエンドポイントを使用する必要があります。切断してから正しいリージョンで再接続してください。
</Accordion>

<Accordion title="接続後に権限または認可エラー">
  キーのユーザーにMCPサーバーの読み取りロールが不足している可能性があります。**Organization Read Only**、**Organization Manager**、**Organization Product Admin**、またはMCP読み取り権限を持つカスタム組織スコープロールを割り当ててください。ユーザーが期待するデータのアカウントへのアクセス権を持っていることを確認してください。
</Accordion>

<Accordion title="MCP接続がまったく機能しない">
  **Administration → Previews & Trials** で **New Relic AI MCP server** プレビューが有効になっていることを確認してください。プレビューが有効になるまで接続は機能しません。
</Accordion>

***

## セキュリティ

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

- **ユーザーAPIキーのみ** — ユーザーキー（`NRAK-…`）を使用してください。ライセンスキー、インジェストキー、クエリキーはMCPリクエストを認証しません。
- **専用の読み取り専用サービスユーザー** — 読み取り専用ユーザーのもとでキーを作成し、最小限の権限をキーが継承するようにしてください。

***

## 関連情報

<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="Grafana 接続" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/grafana.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c1329049025cd3c3a0909b400baef7be" href="/ja/guide/connections/grafana" width="24" height="24" data-path="images/icons/grafana.svg">
    メトリクスとダッシュボード
  </Card>
</CardGroup>