Модуль dellemc.enterprise_sonic.sonic_drop_counter — управление конфигурацией счетчиков отброшенных пакетов в SONiC

Примечание

Этот модуль входит в коллекцию dellemc.enterprise_sonic (версия 3.2.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

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

Чтобы использовать ее в плейбуке, укажите: dellemc.enterprise_sonic.sonic_drop_counter.

Добавлено в dellemc.enterprise_sonic 3.1.0

Краткое описание
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль управляет конфигурацией счетчиков отброшенных пакетов на устройствах под управлением SONiC

Параметры

Параметр	Комментарии
config list / elements=dictionary	Список конфигураций счетчиков отброшенных пакетов
alias string	Псевдоним счетчика отброшенных пакетов
counter_description string	Описание счетчика отброшенных пакетов
counter_type string	Тип счетчика отброшенных пакетов Допустимые значения: `"PORT_INGRESS_DROPS"`
enable boolean	Включить счетчик отброшенных пакетов Допустимые значения: `false` `true`
group string	Группа счетчика отброшенных пакетов
mirror string	Сеанс зеркалирования для зеркалирования счетчика отброшенных пакетов
name string / обязательный	Имя счетчика отброшенных пакетов
reasons list / elements=string	Список причин отбрасывания пакетов Допустимые значения: `"ACL_ANY"` `"ANY"` `"DIP_LINK_LOCAL"` `"EXCEEDS_L3_MTU"` `"FDB_AND_BLACKHOLE_DISCARDS"` `"IP_HEADER_ERROR"` `"L3_EGRESS_LINK_DOWN"` `"MPLS_MISS"` `"SIP_LINK_LOCAL"` `"SMAC_EQUALS_DMAC"`
state string	Состояние конфигурации после выполнения модуля Допустимые значения: `"merged"` ← (по умолчанию) `"deleted"` `"replaced"` `"overridden"`

Примечания

Примечание

Проверено на Enterprise SONiC Distribution от Dell Technologies
Поддерживает check_mode

Примеры

# Using "merged" state
#
# Before state:
# -------------
#
# sonic# show running-configuration dropcounters
# (No 'dropcounters' configuration present)

- name: Merge drop counter configuration
  dellemc.enterprise_sonic.sonic_drop_counter:
    config:
      - name: counter1
        alias: c1
        counter_description: abc
        counter_type: PORT_INGRESS_DROPS
        enable: true
        group: group1
        mirror: session1
        reasons:
          - ANY
    state: merged

# After state:
# ------------
#
# sonic# show running-configuration dropcounters
# !
# dropcounters counter1
#  enable
#  type PORT_INGRESS_DROPS
#  alias c1
#  group group1
#  description "abc"
#  mirror session1
#  add-reason ANY


# Using "replaced" state
#
# Before state:
# -------------
#
# sonic# show running-configuration dropcounters
# !
# dropcounters counter1
#  enable
#  type PORT_INGRESS_DROPS
#  alias c1
#  group group1
#  description "abc"
#  mirror session1
#  add-reason ANY
# !
# dropcounters counter2
#  no enable
#  type PORT_INGRESS_DROPS
#  alias drop2
#  group group2
#  description "xyz789"
#  add-reason IP_HEADER_ERROR,L3_EGRESS_LINK_DOWN,SMAC_EQUALS_DMAC

- name: Replace drop counter configuration
  dellemc.enterprise_sonic.sonic_drop_counter:
    config:
      - name: counter1
        counter_description: abc123
    state: replaced

# After state:
# ------------
#
# sonic# show running-configuration dropcounters
# !
# dropcounters counter1
#  description "abc123"
# !
# dropcounters counter2
#  no enable
#  type PORT_INGRESS_DROPS
#  alias drop2
#  group group2
#  description "xyz789"
#  add-reason IP_HEADER_ERROR,L3_EGRESS_LINK_DOWN,SMAC_EQUALS_DMAC


# Using "overridden" state
#
# Before state:
# -------------
#
# sonic# show running-configuration dropcounters
# !
# dropcounters counter1
#  enable
#  type PORT_INGRESS_DROPS
#  alias c1
#  group group1
#  description "abc"
#  mirror session1
#  add-reason ANY
# !
# dropcounters counter2
#  no enable
#  type PORT_INGRESS_DROPS
#  alias drop2
#  group group2
#  description "xyz789"
#  add-reason IP_HEADER_ERROR,L3_EGRESS_LINK_DOWN,SMAC_EQUALS_DMAC

- name: Override drop counter configuration
  dellemc.enterprise_sonic.sonic_drop_counter:
    config:
      - name: counter3
        alias: c3
        counter_description: qwerty
        counter_type: PORT_INGRESS_DROPS
        enable: true
        group: group3
        mirror: session2
        reasons:
          - ACL_ANY
          - FDB_AND_BLACKHOLE_DISCARDS
    state: overridden

# After state:
# ------------
#
# sonic# show running-configuration dropcounters
# !
# dropcounters counter3
#  enable
#  type PORT_INGRESS_DROPS
#  alias c3
#  group group3
#  description "qwerty"
#  mirror session2
#  add-reason ACL_ANY,FDB_AND_BLACKHOLE_DISCARDS


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration dropcounters
# !
# dropcounters counter1
#  enable
#  type PORT_INGRESS_DROPS
#  alias c1
#  group group1
#  description "abc"
#  mirror session1
#  add-reason ANY
# !
# dropcounters counter2
#  no enable
#  type PORT_INGRESS_DROPS
#  alias drop2
#  group group2
#  description "xyz789"
#  add-reason IP_HEADER_ERROR,L3_EGRESS_LINK_DOWN,SMAC_EQUALS_DMAC

- name: Delete drop counter configuration
  dellemc.enterprise_sonic.sonic_drop_counter:
    config:
      - name: counter1
        alias: c1
        counter_description: abc
      - name: counter2
    state: deleted

# After state:
# ------------
#
# sonic# show running-configuration dropcounters
# !
# dropcounters counter1
#  enable
#  type PORT_INGRESS_DROPS
#  group group1
#  mirror session1
#  add-reason ANY


# Using "deleted" state
#
# Before state:
# -------------
#
# sonic# show running-configuration dropcounters
# !
# dropcounters counter1
#  enable
#  type PORT_INGRESS_DROPS
#  group group1
#  mirror session1
#  add-reason ANY

- name: Delete all drop counter configuration
  dellemc.enterprise_sonic.sonic_drop_counter:
    config:
    state: deleted

# After state:
# ------------
#
# (No 'dropcounters' configuration present)

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
after list / elements=string	Конфигурация, полученная в результате вызова модуля. Возвращается: при изменении
after(generated) list / elements=string	Конфигурация, сгенерированная при вызове модуля. Возвращается: если `check_mode`
before list / elements=string	Конфигурация до вызова модуля. Возвращается: всегда
commands list / elements=string	Набор команд, отправленных на удаленное устройство. Возвращается: всегда Пример: `["command 1", "command 2", "command 3"]`

Авторы

1. Talabi (@stalabi1)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/dellemc/enterprise_sonic/sonic_drop_counter_module.html