<linkrel="prev"title="prometheus.prometheus.chrony_exporter role – Prometheus Chrony Exporter"href="chrony_exporter_role.html"/><!-- extra head elements for Ansible beyond RTD Sphinx Theme -->
<liclass="toctree-l1"><aclass="reference internal"href="alertmanager_role.html">prometheus.prometheus.alertmanager role – Prometheus Alertmanager service</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="blackbox_exporter_role.html">prometheus.prometheus.blackbox_exporter role – Deploy and manage Prometheus blackbox exporter</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="node_exporter_role.html">prometheus.prometheus.node_exporter role – Prometheus Node Exporter</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="prometheus_role.html">prometheus.prometheus.prometheus role – Installs and configures prometheus</a></li>
<h1>prometheus.prometheus.mysqld_exporter role – Prometheus MySQLd Exporter<aclass="headerlink"href="#prometheus-prometheus-mysqld-exporter-role-prometheus-mysqld-exporter"title="Permalink to this heading"></a></h1>
<p>This role is part of the <aclass="reference external"href="https://galaxy.ansible.com/prometheus/prometheus">prometheus.prometheus collection</a> (version 0.6.0).</p>
<p>To install it use: <codeclass="code docutils literal notranslate"><spanclass="pre">ansible-galaxy</span><spanclass="pre">collection</span><spanclass="pre">install</span><spanclass="pre">prometheus.prometheus</span></code>.</p>
<p>To use it in a playbook, specify: <codeclass="code docutils literal notranslate"><spanclass="pre">prometheus.prometheus.mysqld_exporter</span></code>.</p>
</div>
<navclass="contents local"id="contents">
<ulclass="simple">
<li><p><aclass="reference internal"href="#entry-point-main-prometheus-mysqld-exporter"id="id1">Entry point <codeclass="docutils literal notranslate"><spanclass="pre">main</span></code>– Prometheus MySQLd Exporter</a></p>
<h2><aclass="toc-backref"href="#id1"role="doc-backlink">Entry point <codeclass="docutils literal notranslate"><spanclass="pre">main</span></code>– Prometheus MySQLd Exporter</a><aclass="headerlink"href="#entry-point-main-prometheus-mysqld-exporter"title="Permalink to this heading"></a></h2>
<sectionid="synopsis">
<h3><aclass="toc-backref"href="#id2"role="doc-backlink">Synopsis</a><aclass="headerlink"href="#synopsis"title="Permalink to this heading"></a></h3>
<ulclass="simple">
<li><p>Deploy prometheus <aclass="reference external"href="https://github.com/prometheus/mysqld_exporter">mysqld_exporter</a> using ansible</p></li>
</ul>
</section>
<sectionid="parameters">
<h3><aclass="toc-backref"href="#id3"role="doc-backlink">Parameters</a><aclass="headerlink"href="#parameters"title="Permalink to this heading"></a></h3>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_basic_auth_users"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">dictionary</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>Dictionary of users and password for basic authentication. Passwords are automatically hashed with bcrypt.</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_binary_install_dir"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_binary_local_dir"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>Enables the use of local packages instead of those distributed on github.</p>
<p>The parameter may be set to a directory where the <codeclass="docutils literal notranslate"><spanclass="pre">mysqld_exporter</span></code> binary is stored on the host where ansible is run.</p>
<p>This overrides the <em>mysqld_exporter_version</em> parameter</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_binary_url"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>URL of the mysqld_exporter binaries .tar.gz file</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_checksums_url"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>URL of the mysqld_exporter checksums file</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_config_dir"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>The path where exporter configuration is stored</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_config_file"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>The filename of the exporter mysql config file</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_disabled_collectors"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">list</span> / <spanclass="ansible-option-elements">elements=string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>List of disabled collectors.</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_enabled_collectors"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">list</span> / <spanclass="ansible-option-elements">elements=string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>List of dicts defining additionally enabled collectors and their configuration.</p>
<p>It adds collectors to <aclass="reference external"href="https://github.com/prometheus/mysqld_exporter#enabled-by-default">those enabled by default</a>.</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_host"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>The target MySQL host</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_http_server_config"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">dictionary</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>Config for HTTP/2 support.</p>
<p>Keys and values are the same as in <aclass="reference external"href="https://github.com/prometheus/mysqld_exporter/blob/master/https/README.md#sample-config">mysqld_exporter docs</a>.</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_password"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>The password for MySQL login</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_port"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>The target MySQL port</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_skip_install"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">boolean</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>MySQLd installation tasks gets skipped when set to true.</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_socket"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>The target MySQL unix socket</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_system_group"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_system_user"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_tls_server_config"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">dictionary</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>Configuration for TLS authentication.</p>
<p>Keys and values are the same as in <aclass="reference external"href="https://github.com/prometheus/mysqld_exporter/blob/master/https/README.md#sample-config">mysqld_exporter docs</a>.</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_username"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>The username for MySQL login</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_version"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>MySQLd exporter package version. Also accepts latest as parameter.</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_web_listen_address"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>Address on which mysqld_exporter will listen</p>
<aclass="ansibleOptionLink"href="#parameter-main--mysqld_exporter_web_telemetry_path"title="Permalink to this option"></a><pclass="ansible-option-type-line"><spanclass="ansible-option-type">string</span></p>
</div></td>
<td><divclass="ansible-option-cell"><p>Path under which to expose metrics</p>