普罗米修斯 MySQL 导出器

这个 Prometheus 导出器定期对 MySQL 服务器运行配置的查询，并将结果导出为 Prometheus 计量指标。

源代码| Python 包| 码头工人图片| 头盔图

安装

导出器需要安装 Python 3 和 Pip 3。

要通过 Pip 安装最新发布的版本，请运行：

> pip3 install prometheus-mysql-exporter

请注意，您可能需要将启动脚本位置（请参阅 pip 输出）添加到您的PATH.

用法

安装后，您可以使用命令运行导出器prometheus-mysql-exporter。

默认情况下，它将绑定到端口 9207，localhost:3306使用root用户（无密码）查询 MySQL，并运行exporter.cfg在工作目录中的文件中配置的查询。您可以通过传入选项来更改任何默认值或其他设置：

> prometheus-mysql-exporter -p <port> -s <mysql server> -u <mysql username> -P <mysql password> -z <local timezone> -c <path to query config file>

使用标志运行-h以查看所有可用选项的详细信息。

请注意，所有选项都可以通过环境变量进行设置。环境变量名称以 为前缀MYSQL_EXPORTER，例如MYSQL_EXPORTER_MYSQL_USER=fred等同于--mysql-user fred. CLI 选项优先于环境变量。

命令行选项也可以从配置文件中设置，通过传递--config FILE. 文件的格式应该是Configobj 的 unrepre 模式，所以--mysql-user fred你可以使用其中的配置文件config_file，mysql-user="fred"然后通过--config config_file. CLI 选项和环境变量优先于配置文件。

CLI 选项、环境变量和配置文件都会覆盖任何默认选项。给定选项的完整分辨率顺序为：CLI > 环境 > 配置文件 > 默认。

有关查询配置示例和说明，请参阅提供的exporter.cfg文件。

码头工人

发布版本的 Docker 镜像可以在 Docker Hub 上找到（注意没有latest提供版本）：

> sudo docker pull braedon/prometheus-mysql-exporter:<version>

要成功运行容器，您需要挂载查询配置文件/usr/src/app/exporter.cfg并将容器端口 9207 映射到主机上的端口。放置在图像名称 ( prometheus-mysql-exporter) 之后的任何选项都将传递给容器内的进程。例如，您将需要使用它来配置 MySQL 服务器，使用-s.

> sudo docker run --rm --name exporter \
    -v <path to query config file>:/usr/src/app/exporter.cfg \
    -p <host port>:9207 \
    braedon/prometheus-mysql-exporter:<version> -s <mysql server>

如果您不想在运行时挂载查询配置文件，您可以使用自己的 Dockerfile 扩展现有映像，该 Dockerfile 在构建时复制配置文件。

舵

Helm 图表可从位于https://braedon.github.io/helm的 Helm 存储库获得。

> helm repo add braedon https://braedon.github.io/helm
> helm repo update

> helm install braedon/prometheus-mysql-exporter --name <release name> \
                                                 --set mysql.server=<mysql server address> \
                                                 --set image.tag=<image tag>

有关如何配置图表的更多详细信息，请参阅prometheus-mysql-exporter图表自述文件。

发展

要直接从 git repo 安装，请在根项目目录中运行以下命令：

> pip3 install .

-e可以使用 pip 的标志以“可编辑”模式安装导出器。这使您无需重新安装即可测试更改。

> pip3 install -e .

要直接从 git repo 构建 docker 映像，请在根项目目录中运行以下命令：

> sudo docker build -t <your repository name and tag> .

如果您有想要贡献的更改，请给我发送 PR！