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

# MySQL 用 prometheus_exporter 拡張機能

> prometheus_exporter コミュニティ拡張機能は、MySQL の内部から Prometheus の /metrics エンドポイントを提供し、ステータス変数、InnoDB メトリクス、およびレプリケーションを対象とします。

Prometheus のために MySQL をスクレイプするには、通常、ログインしてポーリングする別のエクスポータープロセスを実行する必要があります。`prometheus_exporter` は代わりにサーバーの内部から `/metrics` エンドポイントを提供するため、デプロイし、認証し、稼働させ続けるプロセスが 1 つ減ります。

| | |
| - | - |
| **メンテナー** | [ProxySQL](https://github.com/ProxySQL) |
| **ソースとドキュメント** | [ProxySQL/vsql-prometheus-exporter](https://github.com/ProxySQL/vsql-prometheus-exporter) |
| **ライセンス** | GPL-2.0 |

> [!NOTE]
>
> この拡張機能はサードパーティが作成し、保守しています。VillageSQL はこれをビルド、テスト、または提供しておらず、以下の説明はメンテナー自身のドキュメントに従っています。これに依存する前に、そのドキュメントを読んでください。

## インストール

> [!WARNING]
>
> リポジトリのデフォルトブランチのコードは、現在の SDK に対してビルドできません。2026 年 5 月に SDK から削除された `make_sys_var_bool` と `make_status_var_int` を呼び出しているためです。移植済みのコードはオープンなプルリクエスト [#4](https://github.com/ProxySQL/vsql-prometheus-exporter/pull/4) にあります。このコードはプレビュー機能を宣言しているため、それを読み込むサーバーは `--vsql_allow_preview_extensions=ON` で起動する必要があります。

VillageSQL のビルドツリー (`VillageSQL_BUILD_DIR`) に対してそのブランチからビルドし、`.veb` ファイルをサーバーの `veb_dir` にコピーして、インストールします。

```sql theme={null}
INSTALL EXTENSION prometheus_exporter;
```

## 追加される機能

HTTP リスナーと 3 つの設定を追加します。SQL 関数は追加しません。

| 設定 | デフォルト | 制御内容 |
| - | - | - |
| `prometheus_exporter.enabled` | `OFF` | リスナーを実行するかどうか |
| `prometheus_exporter.port` | `9104` | リッスンするポート |
| `prometheus_exporter.bind_address` | `127.0.0.1` | バインドするアドレス |

5 つのメトリクスファミリーがエクスポートされ、それぞれ取得元にちなんで名付けられています。

| プレフィックス | 取得元 |
| - | - |
| `mysql_global_status_` | `SHOW GLOBAL STATUS` |
| `mysql_global_variables_` | 数値のサーバー変数 |
| `mysql_innodb_metrics_` | `information_schema.innodb_metrics` |
| `mysql_replica_` | レプリカ上の `performance_schema` レプリケーションテーブル |
| `mysql_binlog_` | `SHOW BINARY LOGS` |

エクスポーターは、`requests_total`、`scrape_duration_us`、および `errors_total` を通じて自身についても報告します。

## 例

メンテナーのクイックスタートは、これを有効にしてポートを選びます。

```sql theme={null}
INSTALL EXTENSION prometheus_exporter;
SET GLOBAL prometheus_exporter.port = 9104;
SET GLOBAL prometheus_exporter.enabled = ON;
```

Prometheus は `http://127.0.0.1:9104/metrics` をスクレイプします。スタンドアロンの `mysqld_exporter` など別のプロセスがすでにポート 9104 を使用している場合、`enabled` は `ON` と読めるのに何も応答しないため、`curl` でエンドポイントを確認してください。

> [!WARNING]
>
> リスナーは変更しない限り localhost にバインドし、それが安全な選択です。メトリクスはあなたのトラフィックと設定を表すため、ループバックアドレスから移す前に、ポートを認証を行うものの内側に置いてください。

## 関連項目

* [利用可能な拡張機能](https://villagesql.com/docs/ja/extensions/catalog) — 完全なカタログ
* [ProxySQL/vsql-prometheus-exporter](https://github.com/ProxySQL/vsql-prometheus-exporter) — ソース、メトリクスの一覧、およびテストスイート


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