Extend の可観測性入門

Last updated on July 23, 2026

AI翻訳

このページは AI によって翻訳されています。内容の正確性については英語版を参照してください。

備考

AGS Observability は Extend パッケージ全体の一部であり、AGS の両ティア（Private Cloud と Public Cloud）で利用できます。無料トライアル中の Public Cloud ユーザーの場合、ティアをアンロックすると、可観測性ダッシュボードおよびその他のすべての Extend 機能にアクセスできます。

Overview

AGS Extend には、Extend アプリ向けの組み込み可観測性ダッシュボードが含まれています。これらのダッシュボードはインフラの健全性、サービスのメトリクス、ログをカバーしており、アプリのモニタリングとトラブルシューティングに役立ちます。

Extend は Extend アプリの各タイプに対して可観測性ダッシュボードを提供しています。各アプリタイプのガイドを参照してください。

• Extend Override
• Extend Service Extension
• Extend Event Handler

備考

Extend ダッシュボードのほかに、AGS Observability では Game Health ダッシュボード、AMS ダッシュボード、カスタムダッシュボード（顧客の要望や要件に基づいて作成されたダッシュボード）などの他のダッシュボードも提供されています。詳細については、AGS Observability ページを参照してください。

可観測性ダッシュボードへのアクセス

可観測性ダッシュボードへのアクセスリンクは、Extend アプリの詳細ページから取得できます。以下の手順に従ってください。

1. 表示したい可観測性ダッシュボードを持つ Extend アプリの詳細ページに移動します。

2. App Detail テーブルの下部で、Open Grafana をクリックします。Grafana のサインインページが新しいブラウザタブで開きます。

3. サインインページで Sign in with Admin Portal ボタンをクリックし、Admin Portal の認証情報を使用してログインします。

可観測性ダッシュボードの操作方法については、各アプリタイプのガイドを参照してください。

• Extend Override
• Extend Service Extension
• Extend Event Handler

インフラの健全性メトリクス

Grafana では、以下のインフラメトリクスを利用できます。

• アプリインスタンス数とステータス
• CPU 使用率
  • Limit
  • Request
• メモリ消費量
  • Limit
  • Request
• ストレージ
  • ディスク容量
  • IOPS
• ネットワーク
  • 帯域幅
  • ネットワーク使用量

サービスの健全性メトリクス

Grafana では、以下のサービスメトリクスにアクセスできます。

• リクエスト数
  • gRPC
    • 総リクエスト数
    • gRPC ステータスコードごとの総リクエスト数
    • リクエストレイテンシ
    • エラー率
  • HTTP
    • 総リクエスト数
    • 2xx の総リクエスト数
    • 4xx の総リクエスト数
    • 5xx の総リクエスト数
    • リクエストレイテンシ
• 受信 Kafka イベント（該当する場合）
• アプリケーション作成時間
• デプロイメント作成時間

メトリクスとログのクエリ機能

アプリケーションのログとメトリクスは、Grafana で直接確認できます。AGS はテナントのデータソースが中央のメトリクスストアとログストアからクエリできるよう設定しているため、アプリのデータは自動的に利用可能になります。メトリクスとログをクエリするには、以下の手順に従ってください。

1. サイドバーで Explore セクションに移動します。

   

2. Grafana には、取得したい正確なメトリクスやログデータを指定できるクエリエディタが用意されています。アプリケーションのデータソースは通常 log-<your studio name> または metrics-<your studio name> というパターンに従います。上部のドロップダウンから、ログ/メトリクス用のデータソースを選択できます。

   

3. アプリケーションのデータを取得するには、ラベルフィルターを適用します。namespace ラベルを選択し、値として extend-accelbyte-custom-service を選択します。また、時間フィルターを利用して結果を絞り込むこともできます。

4. クエリを定義したら、右上の実行ボタンを使ってクエリを実行できます。

   

5. Grafana は、定義されたクエリに基づいて JSON 形式でログとメトリクスを返します。

ログの収集用送信

Extend アプリから可観測性プラットフォームにログを送信するには、標準出力にログを書き込みます。

C#

gRPC サービス実装クラス内でログを書き込むには、ILogger<YourClassName> オブジェクトを使用します。

// Import namespace
using Microsoft.Extensions.Logging;

// Declare private logger object
private readonly ILogger<YourClassName> _Logger;

// Get logger object in constructor
public YourClassName(
  ...
  ILogger<YourClassName> logger,
  ...
)
{
  ...
  _Logger = logger;
  ...
}

// Use it within the method
_Logger.LogInformation("your log message");

Go

// Import required package
import (
  "github.com/sirupsen/logrus"
)

// Write log
logrus.Infof("your log message")

Java

// Import Slf4j package
import lombok.extern.slf4j.Slf4j;

// Add Slf4J annotation to your service class
@Slf4j

// Use it within the method
log.info("your log message");

備考

Slf4j アノテーションの詳細については、Project Lombok ドキュメントを参照してください。

Python

# Import logger
from logging import Logger

# init logger in service class
def __init__(
  ..., logger: Optional[Logger], ...
) -> None:
  ...
  self.logger = logger
  ...

# Use it within the function
self.logger.info("your log message")

Visualization

利用可能なダッシュボードを使用して、Extend サービスの健全性をモニタリングできます。Extend アプリがプロビジョニングされると、以下のダッシュボードが自動的に作成されます。

ダッシュボード

Admin Portal 経由でサインインすると、Grafana でダッシュボードを利用できます。Grafana のサイドバーから Dashboards に移動して、Extend ダッシュボードを参照してください。

カスタムメトリクス

サービス固有のメトリクスに注釈を付けて公開することで、アプリのパフォーマンスに関するさらなる洞察を得ることができます。これらのメトリクスに関するサポートとドキュメントは近日追加予定です。