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

Новый в версии 2.8.

Описание
Требования
Параметры
Примечания
Примеры
Статус

Описание

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

Требования

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

skydive-client

Параметры

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

Примечания

Примечание

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

Примеры

- name: start a new flow capture directly from gremlin query
  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
  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
  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
  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

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается командой Ansible по работе с сетями. [сеть]

Поддержка Red Hat

Дополнительная информация о поддержке этого модуля компанией Red Hat доступна в этой статье базы знаний Red Hat.

Авторы

Сумит Джаисвал (@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.9/modules/skydive_capture_module.html