診断用CLI（nrdiag）の実行

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

Diagnostics CLI は、Linux と Windows で 1 つのコマンドでインストールして実行できます。このインストール方法では、Diagnostics CLI バイナリが現在の作業ディレクトリにダウンロードされます。Diagnostics CLI は、そのルートディレクトリとサブディレクトリを自動的に検索して、エージェント構成ファイルとその他の関連データを探します。

ディレクトリをアプリケーションのルートディレクトリに変更します。
以下を実行します。
```
curl -Ls https://download.newrelic.com/nrdiag/scripts/install.sh | bash && sudo ./nrdiag CLI_OPTIONS
```
推奨事項: タスクスイート (-suites) を使用してトラブルシューティングの範囲を絞り込み、添付ファイルフラグ (-attach) を使用して関連ファイルを New Relic アカウントにアップロードします。

ディレクトリをアプリケーションのルートディレクトリに変更します。

以下を実行します。

[Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; (New-Object System.Net.WebClient).DownloadFile("https://download.newrelic.com/nrdiag/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; & '.\nrdiag.exe' CLI_OPTIONS

推奨事項: タスクスイート (-suites) を使用してトラブルシューティングの範囲を絞り込み、添付ファイルフラグ (-attach) を使用して関連ファイルを New Relic アカウントにアップロードします。

プラットフォーム固有の手動インストール手順

Diagnostics CLI を手動でインストールして実行するには、プラットフォームの手順に従います。

Diagnostics CLIがあることを確認します。
- コマンドラインから、ディレクトリをアプリケーションのルートディレクトリに変更し、 nrdiag.zipファイルが存在することを確認します。
  また
- 最新版を手動でダウンロードする.
必要に応じてnrdiag.zipを解凍します。
nrdiag_1.2.3/linuxディレクトリから、 nrdiagをアプリケーションのルートディレクトリに移動します。
nrdiagを実行します（ CLIオプションと一緒に）
```
./nrdiag CLI_OPTIONS
```
Diagnostics CLI は、検出した問題を出力し、 -attach フラグを含めると関連ファイルを New Relic アカウントにアップロードします。

Diagnostics CLIがあることを確認します。
- コマンドラインから、ディレクトリをアプリケーションのルートディレクトリに変更し、 nrdiag.zipファイルが存在することを確認します。
  また
- 最新版を手動でダウンロードする.
必要に応じてnrdiag.zipを解凍します。
nrdiag_1.2.3/winディレクトリから、 nrdiag.exeまたはnrdiag_x64.exeをアプリケーションのルートディレクトリに移動します。
Webアプリケーションのトラブルシューティングを行うには、プロジェクトの親ディレクトリから実行可能ファイルを実行していることを確認するか、 -cオプションを使用して構成ファイルの場所を指定します。
バイナリを配置したディレクトリから、実行ファイル（任意の CLIオプションと一緒に）を実行します。一部のチェックには昇格したパーミッションが必要なため、最良の結果を得るためには管理者シェルから実行してください。
CLI_OPTIONSを追加した場合は、PowerShell経由で実行します。
```
./nrdiag.exe CLI_OPTIONS
```
OR 、x64システムの場合。
```
./nrdiag_x64.exe CLI_OPTIONS
```
Diagnostics CLI は、検出した問題を出力し、 -attach フラグを含めると関連ファイルを New Relic アカウントにアップロードします。

Diagnostics CLIがあることを確認します。
- コマンドラインから、ディレクトリをアプリケーションのルートディレクトリに変更し、 nrdiag.zipファイルが存在することを確認します。
  また
- 最新版を手動でダウンロードする.
必要に応じてnrdiag.zipを解凍します。
nrdiag_1.2.3/macディレクトリから、 nrdiagをアプリケーションのルートディレクトリに移動します。
nrdiagを実行します（ CLIオプションと一緒に）
```
./nrdiag CLI_OPTIONS
```
-attach フラグを含めると、Diagnostics CLI は検出した問題を出力し、関連するファイルを New Relic アカウントにアップロードします。

Diagnostics CLI の最新バージョンがあることを確認します。必要に応じて、手動で最新バージョンをダウンロードしてください。
必要に応じてnrdiag.zipを解凍します。
nrdiag_1.2.3/ OS ディレクトリから、 nrdiagを実行します ( CLI オプションとともに:
```
./nrdiag -browser-url WEBSITE_URL CLI_OPTIONS
```
-attach フラグを含めると、Diagnostics CLI は検出した問題を出力し、関連するファイルを New Relic アカウントにアップロードします。

Dockerコンテナで実行されているNewRelicでインストルメント化されたアプリケーションのトラブルシューティングを行うには、 docker execコマンドを使用します。

nrdiag_latest.zipファイルをダウンロードして解凍します。
バイナリをコンテナにコピーします。 IMAGE_NAMEをDockerコンテナの名前に置き換えます。
```
docker cp nrdiag/linux/nrdiag IMAGE_NAME:/bin
```
Dockerコンテナでnrdiagコマンドを実行します。上記のようにIMAGE_NAMEを置き換え、 APPLICATION_ROOTをNewRelicエージェントをインストールしたアプリケーションのルートディレクトリに置き換えます。
```
docker exec -it -w APPLICATION_ROOT IMAGE_NAME nrdiag
```
（オプション）終了したら、 nrdiagバイナリを削除します。
```
docker exec IMAGE_NAME rm /bin/nrdiag
```

スイーツフラグ（CLIオプションとして強く推奨）

スイートとは、特定の製品や問題を対象としたヘルスチェックの集合体のことです。スイートを使用することで、トラブルシューティングの範囲を狭めたり、誤検知の発生を減らすことができます。

使用可能なスイートのリストを確認するには、 -help suitesオプションを指定してDiagnosticsCLIを実行します。

./nrdiag -help suites

nrdiagでスイートを実行するには、引数として実行する-suitesフラグと1つ以上のスイート名（たとえば、 java ）を指定します。

LinuxとmacOS：

64ビットシステムの場合
```
./nrdiag_x64 -suites SUITE NAMES
```
ARM64 システムの場合:
```
./nrdiag_arm64 -suites SUITE NAMES
```

ウィンドウズ：

PowerShellから実行するには、 cmdの先頭に./を追加します。

32ビットシステムの場合
```
nrdiag.exe -suites SUITE NAMES
```
64ビットシステムの場合
```
nrdiag_x64.exe -suites SUITE NAMES
```
ARM64 システムの場合:
```
nrdiag_arm64.exe -suites SUITE NAMES
```

スクリプト

スクリプトは、タスクによって収集されない情報用の追加のデータソースを提供します。使用可能なスクリプトのカタログは、Diagnostic CLI の github リポジトリにあります。

スクリプト出力

スクリプト出力は画面に出力され、スクリプトの名前に基づいてファイルに保存されます (例: name-of-script.out)。これは、 -output-pathで指定されたディレクトリに保存されます。デフォルトは現在のディレクトリです。

スクリプトは、現在の作業ディレクトリまたは -output-pathで指定されたディレクトリにファイルを出力することもできます。すべての出力ファイルは、 ScriptOutput/ ディレクトリの結果 zip に含まれています。

スクリプトの結果

スクリプトの実行結果は、次のスキーマを持つ nrdiag-output.json ファイルにあります。

"Script": {
    "Name": "example",
    "Description": "Example Description",
    "Output": "example output",
    "OutputFiles": [
        "/path/to/example.out",
        "/path/to/another-file.out"
    ],
    "OutputTruncated": false
}

Output フィールドには標準出力出力が含まれます。20000 文字を超える場合は切り捨てられ、 OutputTruncated フィールドは trueに設定されます。切り詰められた場合でも、完全な出力は zip ファイル内の ScriptOutput/ ディレクトリで引き続き利用できます。

スクリプトが作成したファイルのリストは、 Outputfiles フィールドにあります。

スクリプトを一覧表示、表示、実行する

zipに追加のファイルを含める

サポートと共有したい追加のファイルがある場合は、 -includeコマンドラインフラグを使用してそれらをnrdiag-output.zipファイルに含めることができます。これは、単一のファイルまたはディレクトリで使用できます。ディレクトリが提供されている場合、そのすべてのサブディレクトリが含まれます。含まれるファイルの合計サイズ制限は4GBです。

これを-attachと組み合わせて使用し、ファイルをNewRelicアカウントにアップロードします。

LinuxとmacOS：

64ビットシステムの場合

./nrdiag_x64 -include /entire/directory/ -attach

ARM64 システムの場合:

./nrdiag_arm64 -include /entire/directory/ -attach

ウィンドウズ：

PowerShellから実行するには、 cmdの先頭に./を追加します。

32ビットシステムの場合
```
nrdiag.exe -include Path\To\File -attach
```

64ビットシステムの場合

nrdiag_x64.exe -include \Entire\Directory\ -attach

ARM64 システムの場合:

nrdiag_arm64.exe -include \Entire\Directory\ -attach

結果をNew Relicアカウントにアップロード

重要

システムが外部 IP アドレスに接続するように構成されていない場合、この方法は機能しません。代わりに、出力ファイルを電子メールに添付して、New Relic サポートに送信してください。

アカウントの自動アップロード

Diagnostics CLI の実行時に結果を New Relic アカウントに自動的にアップロードするには、 -attach または -api-key コマンドラインフラグを使用します。 -attach フラグは、環境内で見つかったすべての New Relic ライセンスキーを検証し、ライセンスキーに関連付けられたアカウントに実行をアップロードします。または、 -api-key フラグは有効なライセンスキーの有無にかかわらず、実行をアップロードするために提供されます。

結果をアカウントにアップロードすると、 nrdiag-output.jsonとnrdiag-output.zipのコンテンツが自動的にアップロードされます。

64ビットシステムの場合
```
./nrdiag_x64 -attach
```
また
```
./nrdiag_x64 -api-key ${API_KEY}
```

ARM64 システムの場合:

./nrdiag_arm64 -attach

また

./nrdiag_arm64 -api-key ${API_KEY}

PowerShellから実行するには、 cmdの先頭に./を追加します。

32ビットシステムの場合
```
nrdiag.exe -attach
```
また
```
nrdiag.exe -api-key ${API_KEY}
```

64ビットシステムの場合

nrdiag_x64.exe -attach

また

nrdiag_x64.exe -api-key ${API_KEY}

ARM64 システムの場合:

nrdiag_arm64.exe -attach

また

nrdiag_arm64.exe -api-key ${API_KEY}

地域の選択

デフォルトでは、Diagnostics CLI は、米国のデータセンターでホストされている New Relic アカウントに結果をアップロードします。アカウントが EU データセンターでホストされている場合は、コマンドに必ず -region eu を追加してください。

./nrdiag -region eu ...

この機械翻訳は参考用に提供されます。

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

Linux

ウィンドウズ

プラットフォーム固有の手動インストール手順

Linux

ウィンドウズ

マックOS

ブラウザのモニタリング

Dockerコンテナ

スイーツフラグ（CLIオプションとして強く推奨）

スクリプト

スクリプト出力

スクリプトの結果

スクリプトを一覧表示、表示、実行する

利用可能なスクリプトをリストする

スクリプトを表示する

スクリプトを実行する

引数を指定してスクリプトを実行する

スイートと一緒にスクリプトを実行する

zipに追加のファイルを含める

結果をNew Relicアカウントにアップロード

重要

アカウントの自動アップロード

Linux と macOS

ウィンドウズ

地域の選択