> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# サーバーメトリック

> GOWAのプロセスメモリ、コンテナの制限、ディスクの使用率、アップタイム、デバイスのカウントを調べます。

`GET /app/metrics` はGOWAサーバーを監視するためのJSONスナップショットを返します。 ルートはサーバーの設定された認証を使用し、`X-Device-Id` または登録されたデバイスを必要としません。

```bash theme={null}
curl --user "$GOWA_USER:$GOWA_PASSWORD" "$GOWA_URL/app/metrics"
```

レスポンスは通常の `code` 、 `message` 、 `results` を使用します。

curl サンプルを実行する前にサーバーの URL と認証情報を設定します。リモートサーバーの HTTPS URL を使用し、設定された場合は `APP_BASE_PATH` を含めます。

```bash theme={null}
export GOWA_URL=http://localhost:3000
export GOWA_USER=admin
export GOWA_PASSWORD=replace-with-your-password
export DEVICE_ID=my-device
```

## トップレベルの結果

| フィールド | 意味 |
| - | - |
| `version` | GOWAのソースバージョン。 |
| `session_store` | `sqlite` または `postgres` セッションデータベースのURIから選択しました。 |
| `devices.total` | 登録済みのデバイス |
| `devices.logged_in` | ログインしているWhatsAppセッションを持つデバイス。 |
| `devices.connected` | 現在のWhatsAppに接続されているデバイス。 |
| `system` | プロセス、メモリ、フォルダ、ファイルシステムのスナップショット。 |

ログインカウントと接続カウントは異なる状態を測定します。保存されたセッションはデバイスが切断されている間もログイン状態を維持できます。

## システムフィールド

| フィールド `results.system` | 意味 |
| - | - |
| `started_at` | プロセス初期化中に記録された RFC 3339 時間。 |
| `uptime_seconds` | 初期化を含め、その時間から経過した秒数。 |
| `go_version` | ランタイムバージョンに移動します。 |
| `cpu_seconds` | ユーザーとシステム時間を含むCPU時間を秒単位で累積処理します。これはCPU使用率ではありません。 |
| `memory.heap_alloc_bytes` | 割り当てられた Go ヒープバイト。 |
| `memory.runtime_sys_bytes` | オペレーティングシステムからGoランタイムによって取得されたバイト。 |
| `memory.process_rss_bytes` | Linux `/proc` から常駐メモリを処理します。 |
| `memory.container_bytes` | コンテナの cgroup によって使用されるメモリ。 |
| `memory.container_limit_bytes` | コンテナのメモリ制限。`null` は無制限または利用不可を意味します。 |
| `memory.goroutines` | ゴルーチンの現在の数。 |
| `memory.gc_cycles` | ごみ収集サイクルが完了しました。 |
| `folders.media.bytes` と `.files` | 設定されたメディア ツリーのサイズとエントリ数。 |
| `folders.storages.bytes` と `.files` | 構成されたストレージツリーのサイズとエントリ数。 |
| `filesystem.total_bytes` | ストレージディレクトリを含むファイルシステムの合計容量。 |
| `filesystem.free_bytes` | そのファイルシステムの空き容量です。 |

> [!NOTE]
>
> nullableメトリックをゼロではなく未知のものとして扱う。CPU時間とプロセスの常駐メモリはLinuxの`/proc`に依存する。 コンテナーメモリは標準の `/sys/fs/cgroup` マウントを使用し、v1 より前に cgroup v2 を試しています。 これらのフィールドは、他のプラットフォームでは`null`または関連するファイルが使用できない場合に使用できます。

フォルダの測定値は1分間キャッシュされます。これらは最善の努力と判読不能なエントリを省略します。ディレクトリのシンボリックリンクターゲットは横断されません。 フォルダバイトにはリモートのPostgreSQLデータベースは含まれておらず、ファイルシステムのフリースペース測定に代わるものではありません。

## スナップショットのポーリング

モニタリングシステムに適した間隔でアンケートを行います。スナップショット間の累積の`cpu_seconds`値を比較して、間隔でCPU使用率を計算します。 プロセスのアカウントは、デルタを計算する前に `started_at` をチェックして再起動します。

有効化された機能、基本パス、およびメディア制限には`/app/info`を使用します。リソース使用量には`/app/metrics`を使用します。両方のエンドポイントはデバイスが存在する前に動作します。


## Related topics

- [サーバーの健全性指標を取得する](https://gowa-docs.mintlify.site/ja/api-reference/app/サーバーの健全性指標を取得する.md)
- [MCP サーバー](https://gowa-docs.mintlify.site/ja/integrations/mcp.md)
- [GOWA: WhatsApp REST API](https://gowa-docs.mintlify.site/ja/index.md)
- [ニュースレターメッセージからメディアをダウンロード](https://gowa-docs.mintlify.site/ja/api-reference/newsletter/ニュースレターメッセージからメディアをダウンロード.md)
- [whatsappサーバーに再接続](https://gowa-docs.mintlify.site/ja/api-reference/app/whatsappサーバーに再接続.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.