Skip to content

Updated MySQL Prometheus documentation #596

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
yqlu merged 6 commits into from
Aug 11, 2023
Merged

Updated MySQL Prometheus documentation #596

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
81a4c3d
updated the minimum exporter version, example configuration, and addi…
algchoo Jul 26, 2023
361e113
updated the minimum supported version in metadata
algchoo Jul 26, 2023
5daec61
update config example to pass a config file as an argument
algchoo Aug 1, 2023
9b1f6dc
reverted min versions, added volume to the config example that mounts…
algchoo Aug 3, 2023
5f0f960
added + symbols for configmap in example yaml
algchoo Aug 3, 2023
ab57dc2
removed a few dashes, updated the volume section, added mysql image t…
algchoo Aug 10, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 27 additions & 8 deletions integrations/mysql/documentation.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,16 @@ minimum_exporter_version: v0.14.0
multiple_dashboards: false
dashboard_display_name: {{app_name_short}} Prometheus Overview
config_mods: |
+ apiVersion: v1
+ kind: ConfigMap
+ metadata:
+ name: mysql-exporter-config
+ data:
+ my.cnf: |
+ [client]
+ user=root
+ password=password
---
apiVersion: apps/v1
Copy link
Collaborator

@yqlu yqlu Aug 2, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As per the other example, we can update https://github.com/GoogleCloudPlatform/prometheus-engine/blob/main/examples/mysql/exporter.yaml.snippet directly (after addressing the other comments here)

But unlike the consul example, this PR doesn't become completely obsolete -- we do still need to update this file because of the change you made in line 70 (additional_install_info).

Copy link
Contributor Author

@algchoo algchoo Aug 3, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds good, just for clarity I wanted to make sure that the line you're mentioning here doesn't need to be changed? We just want to update things in this repo and the other one, right?

Copy link
Collaborator

@yqlu yqlu Aug 3, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yep

kind: StatefulSet
metadata:
Expand All @@ -27,15 +37,18 @@ config_mods: |
spec:
containers:
+ - name: exporter
+ image: prom/mysqld-exporter:v0.14.0
+ env:
+ - name: DATA_SOURCE_NAME
+ value: root:password@(localhost:3306)/
+ image: prom/mysqld-exporter:v0.15.0
+ args:
+ - --config.my-cnf=/home/my.cnf
+ ports:
+ - containerPort: 9104
+ name: prometheus
- image: mysql:5.7
name: mysql
+ volumeMounts:
+ - mountPath: /home/my.cnf
+ subPath: my.cnf
+ name: mysql-exporter-config
- name: mysql
image: mysql:5.7
env:
- name: MYSQL_ROOT_PASSWORD
value: password
Expand All @@ -47,7 +60,13 @@ config_mods: |
value: sbtest
ports:
- containerPort: 3306
name: mysql
+ volumes:
+ - name: mysql-exporter-config
+ configMap:
+ name: mysql-exporter-config
+ items:
+ - key: my.cnf
+ path: my.cnf
podmonitoring_config: |
apiVersion: monitoring.googleapis.com/v1
kind: PodMonitoring
Expand All @@ -68,7 +87,7 @@ podmonitoring_config: |
additional_prereq_info: |
For information about creating a least-privileged user, see [Required Grants](https://github.com/prometheus/mysqld_exporter#required-grants){:class=external}.
additional_install_info:
Update the `DATA_SOURCE_NAME` environment variable with credentials that work with your {{app_name}} instance.
Update the `--config.my-cnf` argument with a path to a configuration file with credentials that work with your {{app_name}} instance
sample_promql_query: up{job="mysql", cluster="{{cluster_name}}", namespace="{{namespace_name}}"}
alerts_config: |
apiVersion: monitoring.googleapis.com/v1
Expand Down