Azure Spring Apps のアプリケーション コンソール ログをリアルタイムでストリーミングする

Azure portal でログをストリーミングするには、次の手順に従います。

1. Azure Spring Apps サービス インスタンスの [概要] ページに移動し、ナビゲーション ペインの [アプリ] を選択します。

2. ターゲット アプリを見つけ、コンテキスト メニューを選択します。

3. ポップアップ コンテキスト メニューで、[ログ ストリームの表示] を選択します。

   

既定では、ランダムに選択されたアプリ インスタンスについてログのストリーミングが開始されます。 その後で、目的とする操作を実行できます。

便宜上、ログをストリーミングするためのエントリ ポイントは多数あります。 それらは、次のペインにあります。

• [アプリ リスト] ペイン
• [デプロイ リスト] ペイン
• [アプリ インスタンス リスト] ペイン

このセクションでは、Azure CLI を使ってログ末尾を生成する例を示します。 リソース グループとサービス インスタンス名を繰り返し指定するのを避けるには、次のコマンドを使って既定のリソース グループ名とクラスター名を設定します。

az config set defaults.group=<service-group-name>
az config set defaults.spring=<service-instance-name>

次の例では、リソース グループとサービス名は省略されています。

単一インスタンスのアプリのログ末尾を表示する

auth-service という名前のアプリのインスタンスが 1 つだけの場合は、次のコマンドを使ってアプリ インスタンスのログを表示できます。

az spring app logs --name <application-name>

このコマンドからは、次の例のようなログが返されます。ここで、auth-service はアプリケーション名です。

...
2020-01-15 01:54:40.481  INFO [auth-service,,,] 1 --- [main] o.apache.catalina.core.StandardService  : Starting service [Tomcat]
2020-01-15 01:54:40.482  INFO [auth-service,,,] 1 --- [main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.22]
2020-01-15 01:54:40.760  INFO [auth-service,,,] 1 --- [main] o.a.c.c.C.[Tomcat].[localhost].[/uaa]  : Initializing Spring embedded WebApplicationContext
2020-01-15 01:54:40.760  INFO [auth-service,,,] 1 --- [main] o.s.web.context.ContextLoader  : Root WebApplicationContext: initialization completed in 7203 ms

...

複数インスタンスのアプリのログ末尾を表示する

auth-service という名前のアプリに対して複数のインスタンスが存在する場合は、-i/--instance オプションを使用してインスタンスのログを表示できます。

最初に、次のコマンドを実行して、アプリ インスタンスの名前を取得します。

az spring app show --name auth-service --query properties.activeDeployment.properties.instances --output table

このコマンドでは、次の出力のような結果が生成されます。

Name                                         Status    DiscoveryStatus
-------------------------------------------  --------  -----------------
auth-service-default-12-75cc4577fc-pw7hb  Running   UP
auth-service-default-12-75cc4577fc-8nt4m  Running   UP
auth-service-default-12-75cc4577fc-n25mh  Running   UP

次に、次のように、-i/--instance オプションを使って、アプリ インスタンスのログをストリーミングできます。

az spring app logs --name auth-service --instance auth-service-default-12-75cc4577fc-pw7hb

アプリ インスタンスの詳細は、Azure portal から取得することもできます。 Azure Spring Apps サービスの左側のナビゲーション ウィンドウで [アプリ] を選択した後、[アプリ インスタンス] を選択します。

新しいログを継続的にストリーミングする

既定では、az spring app logs は、アプリ コンソールにストリーミングされた既存のログのみを出力し、終了します。 新しいログをストリーミングする場合は、次の例に示すように、-f/--follow 引数を追加します。

az spring app logs --name auth-service --follow

--follow 引数を使ってインスタント ログの末尾を設定すると、Azure Spring Apps ログ ストリーミング サービスは、アプリケーションがログを常に書き込まない限り、クライアントにハートビート ログを 1 分ごとに送信します。 ハートビート ログ メッセージの形式は 2020-01-15 04:27:13.473: No log from server です。

サポートされているすべてのログ オプションを確認するには、次のコマンドを使います。

az spring app logs --help

JSON の構造化されたログの書式設定

構造化されたアプリケーション ログは JSON 形式で表示され、読みにくい場合があります。 --format-json 引数を使うと、JSON 形式のログをさらに読みやすい形式に書式設定できます。 詳しくは、「Azure Spring Apps の構造化アプリケーション ログ」をご覧ください。

次の例は、--format-json 引数の使い方を示したものです。

# Raw JSON log
$ az spring app logs --name auth-service
{"timestamp":"2021-05-26T03:35:27.533Z","logger":"com.netflix.discovery.DiscoveryClient","level":"INFO","thread":"main","mdc":{},"message":"Disable delta property : false"}
{"timestamp":"2021-05-26T03:35:27.533Z","logger":"com.netflix.discovery.DiscoveryClient","level":"INFO","thread":"main","mdc":{},"message":"Single vip registry refresh property : null"}

# Formatted JSON log
$ az spring app logs --name auth-service --format-json
2021-05-26T03:35:27.533Z  INFO [           main] com.netflix.discovery.DiscoveryClient   : Disable delta property : false
2021-05-26T03:35:27.533Z  INFO [           main] com.netflix.discovery.DiscoveryClient   : Single vip registry refresh property : null

--format-json 引数は、書式設定文字列構文を使ってカスタマイズされたオプションの形式を受け取ることもできます。 詳しくは、「書式指定文字列の文法」をご覧ください。

次に示すのは、書式設定文字列構文の使い方の例です。

# Custom format
$ az spring app logs --name auth-service --format-json="{message}{n}"
Disable delta property : false
Single vip registry refresh property : null

使用されている既定の形式は次のとおりです。

{timestamp} {level:>5} [{thread:>15.15}] {logger{39}:<40.40}: {message}{n}{stackTrace}

公衆ネットワークでログ ストリーミング エンドポイントを有効にするには、次の手順に従います。

1. ご利用の仮想ネットワークにデプロイされている Azure Spring Apps サービス インスタンスを選び、ナビゲーション メニューで [ネットワーク] を選びます。

2. [VNet インジェクション] タブを選びます。

3. [公衆ネットワークのデータプレーン リソース] の状態を [有効] に切り替えて、公衆ネットワークでのログ ストリーミング エンドポイントを有効にします。 このプロセスには数分かかります。

   

ログ ストリーム パブリック エンドポイントを有効にするには、次のコマンドを使います。

az spring update \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --enable-dataplane-public-endpoint true