chrissam.pmm-client

Ansible Role: pmm-client

This role installs and sets up the pmm-client on RHEL/CentOS or Debian/Ubuntu servers.

---

Requirements

There are no specific requirements. However, you need root access. You can either run this role in a playbook with become: yes, or use it in your playbook like this:

- hosts: pmm-client
  roles:
    - role: chrissam.pmm-client
      become: yes

---

Role Variables

Here are the available variables, along with their default values (check vars/main.yml):

• pmm_client_RedHat_repo:
  The URL to set up the Percona yum repository (optional). Leave this commented to use the default.

---

• pmm_client_Debian_repo:
  The URL to set up the Percona apt repository (optional). Leave this commented to use the default.

---

• pmm_client_server_host: 192.168.33.10
  The IP address or domain name of the PMM server that the client will connect to.

---

• pmm_client_BASIC: true
  Set this to true if you haven’t enabled authentication or SSL on the PMM server.

---

• pmm_client_http_port:
• pmm_client_https_port:
  If you used a non-default port when setting up the PMM server, enter the HTTP and HTTPS ports here. Leave these commented to use the default.

---

• pmm_client_PROTECTED: true
  Set this to true if you enabled authentication on the PMM server.

---

• pmm_client_server_username:
• pmm_client_server_password:
  If pmm_client_PROTECTED is true, provide the username and password for connecting to the PMM server here.

---

• pmm_client_SSL: true
  Set this to true if you have enabled SSL encryption on the PMM server.

---

• pmm_client_default_cert: false
  Set this to true if you used a self-signed certificate for encryption on the PMM server.

---

• pmm_client_add_service:
  • mysql:metrics
  • mysql:queries
  • linux:metrics
    List the services to be added for monitoring.

---

• pmm_client_remove_service: []
  List of services to be removed.

---

• pmm_client_db_username:
• pmm_client_db_password:
  Provide the username and password for MySQL or MongoDB. This is needed to add database services.

---

• pmm_client_service_start:
  • linux:metrics
  • mysql:metrics
  • mysql:queries
    List of services to start.

---

• pmm_client_service_stop: []
  List of services to stop.

---

• pmm_client_UNINSTALL: false
  Set this to true if you want to uninstall the PMM client.

---

Example Playbook

- hosts: pmm-client
  become: yes

  vars:
    pmm_client_https_port: 9443
  
  roles:
    - chrissam.pmm-client

---

License MIT / BSD

---

Author

This role was created by Chris Sam for devopsideas