influxdb_query - Запрос точек данных из InfluxDB.
Новая версия в версии 2.5.
Обзор
- Запрос точек данных из InfluxDB.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- influxdb >= 0.9
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| database_name обязательно | Имя базы данных. | |
| hostname | По умолчанию: "localhost" | Имя хоста или IP-адрес, на котором слушает сервер InfluxDB. С версии 2.5, по умолчанию localhost. |
| password | По умолчанию: "root" | Пароль, который будет использоваться для аутентификации на сервере InfluxDB. Псевдоним login_password добавлен в версии 2.5.Псевдонимы: login_password |
| port | По умолчанию: 8086 | Порт, на котором слушает сервер InfluxDB |
| proxies (добавлено в 2.5) | HTTP(S) прокси, который следует использовать для запросов к серверу InfluxDB. | |
| query обязательно | Запрос, который будет выполнен. | |
| retries (добавлено в 2.5) | По умолчанию: 3 | Количество попыток, которое клиент предпримет перед прерыванием. 0 указывает на попытки до успеха. |
| ssl (добавлено в 2.5) | Использовать https вместо http для подключения к серверу InfluxDB. | |
| timeout (добавлено в 2.5) | Количество секунд, в течение которых запросы будут ждать, пока клиент установит соединение. | |
| udp_port (добавлено в 2.5) | По умолчанию: 4444 | Порт UDP для подключения к серверу InfluxDB. |
| use_udp (добавлено в 2.5) | Использовать UDP для подключения к серверу InfluxDB. | |
| username | По умолчанию: "root" | Имя пользователя, которое будет использоваться для аутентификации на сервере InfluxDB. Псевдоним login_username добавлен в версии 2.5.Псевдонимы: login_username |
| validate_certs (добавлено в 2.5) | По умолчанию: "да" | Если установлено в no, сертификаты SSL не будут проверены.Это следует установить в no только на сайтах, находящихся под личным контролем, использующих самозаверяющие сертификаты. |
Примеры
- name: Query connections
influxdb_query:
hostname: "{{ influxdb_ip_address }}"
database_name: "{{ influxdb_database_name }}"
query: "select mean(value) from connections"
register: connection
- name: Query connections with tags filters
influxdb_query:
hostname: "{{ influxdb_ip_address }}"
database_name: "{{ influxdb_database_name }}"
query: "select mean(value) from connections where region='zue01' and host='server01'"
register: connection
- name: Print results from the query
debug:
var: connection.query_results
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| query_results список | успех | Результат запроса Пример: [{'mean': 1245.5333333333333, 'time': '1970-01-01T00:00:00Z'}] |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантируется как обратная совместимость.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. Поддержка и техническое обслуживание модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- René Moser (@resmo)
Подсказка
Если вы заметите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/influxdb_query_module.html
