Extend の可観測性入門

Last updated on July 15, 2026

注釈：本資料はAI技術を用いて翻訳されています。

備考

AccelByte Gaming Services (AGS) と Grafana Cloud の統合は Extend パッケージ全体の一部であり、AGS の両ティア（Private Cloud と Public Cloud）で利用できます。無料トライアル中の Public Cloud ユーザーの場合、ティアをアンロックすると Grafana Cloud および他のすべての Extend 機能にアクセスできるようになります。

Overview

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

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

• Extend Override
• Extend Service Extension
• Extend Event Handler

備考

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

Grafana Cloud ダッシュボードへのアクセス

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

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

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

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

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

• Extend Override
• Extend Service Extension
• Extend Event Handler

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

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

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

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

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

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

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

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

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

   

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

   

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

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

   

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

Grafana Cloud へのログ送信

Extend アプリから Grafana Cloud にログを送信するには、標準出力にログを書き込みます。

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 アプリがプロビジョニングされると、以下のダッシュボードが自動的に作成されます。

ダッシュボード

ダッシュボードには次のパスでアクセスできます: https://<your-grafana-dedicated-stack>.grafana.net/dashboards。例えば、スタック URL は次のようになります: https://accelbyte12345.grafana.net/dashboards

カスタムメトリクス

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