Cloud Logging クライアント ライブラリを使用するには、次の 3 つの方法があります。
- オプション 1: ASP.NET Core 統合を使用する
- オプション 2: ASP.NET Framework との Log4Net 統合を使用する
- オプション 3: Logging API を使用してカスタムログを書き込む
オプション 1: ASP.NET Core 統合を使用する
Google.Cloud.Diagnostics.AspNetCore は、標準の ASP.NET ログを Cloud Logging に送信するライブラリです。
Google.Cloud.Diagnostics.AspNetCore を使用してロギングを開始するには、次のコマンドのいずれかを使用してライブラリをインストールします。
パッケージ マネージャ
PM> Install-Package Google.Cloud.Diagnostics.AspNetCore
.NET CLI
> dotnet add package Google.Cloud.Diagnostics.AspNetCore
次に、Startup.cs
ファイルに次の変更を加えます。
次の using ステートメントを
Startup.cs
の先頭に追加します。Configure
関数を変更します。ILoggerFactory loggerFactory
を追加して、loggerFactory.AddGoogle("YOUR-PROJECT-ID")
の呼び出しを追加します。Visual Studio でコードをコンパイルして実行します。ログ エクスプローラの Global リソースの下にログエントリが表示されていることを確認します。
オプション 2: Log4Net 統合を使用する
Log4Net は Apache ライブラリで、ログ ステートメントをさまざまな出力先に出力できます。
Log4Net 統合を使用して Logging を開始するには、次のコマンドで Google.Cloud.Logging.Log4Net ライブラリをインストールします。
PM> Install-Package Google.Cloud.Logging.Log4Net
次に、以下の操作を行います。
ウェブアプリケーションの、次のコードを含む
Web.config
ファイルに Log4Net XML 構成セクションを追加します。Logging を使用するように Log4net を構成するには、アプリケーションの Global.asax.cs ファイルに次のコードの行を追加します。
log4net.Config.XmlConfigurator.Configure();
前の行をコードに追加したら、
Global.asax.cs
のApplication_Start()
メソッドを次のように変更します。log4net をアプリケーション コードで使用するには、以下のステートメントを追加してクライアント ライブラリを含めます。
using log4net;
次のコードをアプリケーションに追加し、ログ エクスプローラの Global リソースの下に表示されるログを書き込みます。ログ名は、
Web.config
ファイルで指定します。Visual Studio でコードをコンパイルして実行します。Logging のログビューアの Global リソースの下にログエントリが表示されていることを確認します。
オプション 3: Logging API を使用してカスタムログを書き込む
代わりに、Cloud Logging API を直接呼び出してカスタムログを書き込むこともできます。
Google.Cloud.Logging.V2 を使用してログを開始するには、次のいずれかのコマンドを使用してライブラリをインストールします。
パッケージ マネージャ
PM> Install-Package Google.Cloud.Logging.V2
.NET CLI
> dotnet add package Google.Cloud.Logging.V2
Logging クライアントをインストールしたら、次の文をアプリケーションコードに追加して、アプリケーションのログを Logging に送信できます。
using Google.Cloud.Logging.V2;
using Google.Cloud.Logging.Type;
using Google.Cloud.Api;
以下のメソッドをカスタマイズして、アプリケーション コードに追加します。
WriteLogEntry()
を呼び出すロギングコードをいくつか作成します。ログエントリが生成されて、ログ エクスプローラの Global リソースの下に表示されます。
ログ エクスプローラの詳細については、ログ エクスプローラの使用をご覧ください。