次の方法で共有

オンプレミス サーバー用に Azure Monitor Application Insights エージェントをデプロイする

Application Insights エージェントは、PowerShell ギャラリーで公開されている PowerShell モジュールです。 これは Status Monitor を置き換えるものです。 テレメトリが Azure portal に送信され、そこでアプリを監視できます。

サポートされている自動インストルメンテーション シナリオの全一覧については、「サポートされている環境、言語、リソース プロバイダー」を参照してください。

注

現在、このモジュールは、IIS でホストされている ASP.NET および ASP.NET Core Web アプリに対して、コードの変更なしでインストルメンテーションを実行できます。 Java および Node.js アプリケーションをインストルメント化するには、SDK を使用します。

注

ASP.NET Core アプリの既定では、クライアント側の監視が有効になっています。 クライアント側の監視を無効にしたい場合には、次の情報を使用して、サーバー内で環境変数を定義します。

  • 名前: APPINSIGHTS_JAVASCRIPT_ENABLED
  • 値: false

Application Insights エージェントは、PowerShell ギャラリーにあります。

PowerShell ギャラリー アイコン。

手順

  • 簡潔なコード サンプルの使用を開始するには、「作業の開始」タブを参照してください。
  • 開始する方法の詳細については、「詳細な手順」タブを参照してください。
  • PowerShell API リファレンスについては、「API リファレンス」タブを参照してください。
  • リリース ノートの更新については、「リリース ノート」タブを参照してください。

このタブには、ほとんどの環境で動作するクイックスタート コマンドが含まれています。 これらの手順では、更新の配布について PowerShell ギャラリーに依存します。 これらのコマンドでは、PowerShell -Proxy パラメーターがサポートされます。

これらのコマンドの説明、カスタマイズの手順、トラブルシューティングの情報については、詳細な手順を参照してください。

Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。

ダウンロードとインストールには PowerShell ギャラリーを使用します。

設置の前提条件

監視を有効にするには、接続文字列が必要です。 接続文字列は、Application Insights リソースの [概要] ペインに表示されます。 詳細については、接続文字列に関するページを参照してください。

注

必要となる可能性のあるその他の前提条件については、「PowerShell ギャラリーにおける TLS (トランスポート層セキュリティ) サポート」に関する情報をご確認ください。

PowerShell を管理者として実行します。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force
Set-PSRepository -Name "PSGallery" -InstallationPolicy Trusted
Install-Module -Name PowerShellGet -Force

PowerShell を閉じます。

Application Insights Agent をインストールする

PowerShell を管理者として実行します。

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Install-Module -Name Az.ApplicationMonitor -AllowPrerelease -AcceptLicense

注

AllowPrerelease コマンドレットの Install-Module スイッチを使用すると、ベータ リリースをインストールできます。

詳細については、「Install-Module」を参照してください。

監視を有効にする

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope Process -Force
Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'

手動でダウンロードしてインストールする (オフライン オプション)

手動でダウンロードしてインストールすることもできます。

モジュールをダウンロードする

PowerShell ギャラリーからモジュールの最新バージョンを手動でダウンロードします。

Application Insights Agent のファイルを解凍してインストールする

$pathToNupkg = "C:\Users\t\Desktop\Az.ApplicationMonitor.0.3.0-alpha.nupkg"
$pathToZip = ([io.path]::ChangeExtension($pathToNupkg, "zip"))
$pathToNupkg | rename-item -newname $pathToZip
$pathInstalledModule = "$Env:ProgramFiles\WindowsPowerShell\Modules\Az.ApplicationMonitor"
Expand-Archive -LiteralPath $pathToZip -DestinationPath $pathInstalledModule

監視を有効にする

Enable-ApplicationInsightsMonitoring -ConnectionString 'InstrumentationKey=00000000-0000-0000-0000-000000000000;IngestionEndpoint=https://xxxx.applicationinsights.azure.com/'
  • Last updated on