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

Новинка в версии 2.8.

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

Обзор

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

Требования

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

skydive-client

Параметры

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

Поддержка Red Hat

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

Авторы

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.8/modules/skydive_capture_module.html