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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/skydive/skydive_capture_module.html