community.skydive.skydive_capture – Модуль, управляющий захватом потоков на интерфейсах

Примечание

Этот плагин является частью коллекции community.skydive (версия 1.0.0).

Для его установки используйте: ansible-galaxy collection install community.skydive.

Для использования в книге задач укажите: community.skydive.skydive_capture.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Этот модуль управляет захватом потоков на интерфейсах. Выражение Gremlin непрерывно оценивается, что означает возможность определения захвата на узлах, которые ещё не существуют.
Он полезен, когда требуется начать захват на всех OpenvSwitch, независимо от количества агентов Skydive, которые будут запущены.
При запуске захвата пользователь может указать имя захвата, описание захвата и тип захвата (необязательно).

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

skydive-client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
capture_name строка		Значение по умолчанию: ""	Для определения имени захвата потока.
description строка		Значение по умолчанию: ""	Настраивает строку текста, которая должна быть ассоциирована с экземпляром этого объекта.
extra_tcp_metric булево		Варианты: нет ← да	Для определения параметра ExtraTCPMetric захвата потока.
interface_name строка			Для определения имени интерфейса захвата потока.
ip_defrag булево		Варианты: нет ← да	Для определения параметра IPDefrag захвата потока.
layer_key_mode строка		Значение по умолчанию: "L2"	Для определения параметра Layer KeyMode захвата потока.
provider строка			Объект словаря, содержащий данные подключения.
	endpoint строка / обязательно		Указывает имя хоста/адрес вместе с портом как `localhost:8082`, для подключения к удаленному экземпляру клиента SKYDIVE через REST API.
	insecure булево	Варианты: нет ← да	Игнорировать проверку сертификата SSL.
	password строка		Указывает пароль для аутентификации подключения к удаленному экземпляру клиента SKYDIVE.
	ssl булево	Варианты: нет ← да	Указывает параметр ssl, определяющий, будет ли тип подключения http или https.
	user строка		Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру клиента SKYDIVE.
query строка			Полное выражение Gremlin, которое пользователь может ввести, например, G.V(.Has('Name', 'eth0', 'Type', 'device')), для создания захвата. Если пользователь напрямую вводит выражение Gremlin, ему не нужно вводить другие параметры модуля, так как выражение Gremlin позаботится о создании захвата потока.
reassemble_tcp булево		Варианты: нет ← да	Для определения параметра ReassembleTCP захвата потока.
state строка		Варианты: present ← absent	Состояние захвата потока. Если значение present, захват потока будет создан; если absent, он будет удален.
type строка			Для определения типа интерфейса захвата потока.

Примечания

Примечание

Этот модуль должен выполняться локально, что можно сделать, указав connection: local.

Примеры

- name: start a new flow capture directly from gremlin query
  community.skydive.skydive_capture:
    query: G.V().Has('Name', 'eth0', 'Type', 'device')
    state: present
    provider:
      endpoint: localhost:8082
      username: admin
      password: admin

- name: stop the flow capture directly from gremlin query
  community.skydive.skydive_capture:
    query: G.V().Has('Name', 'eth0', 'Type', 'device')
    state: absent
    provider:
      endpoint: localhost:8082
      username: admin
      password: admin

- name: start a new flow capture from user's input
  community.skydive.skydive_capture:
    interface_name: Node1
    type: myhost
    capture_name: test_capture
    description: test description
    extra_tcp_metric: true
    ip_defrag: true
    reassemble_tcp: true
    state: present
    provider:
      endpoint: localhost:8082
      username: admin
      password: admin

- name: stop the flow capture
  community.skydive.skydive_capture:
    interface_name: Node1
    type: myhost
    capture_name: test_capture
    description: test description
    extra_tcp_metric: true
    ip_defrag: true
    reassemble_tcp: true
    state: absent
    provider:
      endpoint: localhost:8082
      username: admin
      password: admin

Авторы

Sumit Jaiswal (@sjaiswal)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/skydive/skydive_capture_module.html