Dell-Networking.dellos-logging

日志角色

此角色用于配置全局日志属性,并支持日志服务器的配置。该角色适用于dellos6、dellos9和dellos10。

日志角色需要SSH连接以实现与Dell EMC网络设备的连接。您可以使用任何内置的操作系统连接变量。

安装

ansible-galaxy install Dell-Networking.dellos-logging

角色变量

  • 角色是通过ansible_network_os变量抽象的,可以取值为dellos9、dellos6和dellos10。
  • 如果dellos_cfg_generate变量设置为true,则会在文件中生成角色配置命令。
  • 任何对应状态变量设置为absent的角色变量将取消该变量的配置。
  • 对于任何变量,设置为空值将取消相应的配置。
  • 变量和值区分大小写。

dellos_logging键

类型 描述 支持
logging 列表 配置日志服务器(参见logging.* dellos6, dellos9, dellos10
logging.ip 字符串(必需) 配置日志服务器的IPv4地址(A.B.C.D格式) dellos6, dellos9, dellos10
logging.secure_port 整数 指定通过TLS端口发送日志消息 dellos9
logging.tcp_port 整数 如果未定义secure_port,则指定通过TCP端口发送日志消息 dellos9
logging.udp_port 整数 如果未定义TCP和secure_port键,则指定通过UDP端口发送日志消息 dellos9
logging.vrf 字典 指定用于连接主机的VRF实例 dellos9
logging.vrf.name 字符串 指定VRF名称 dellos9
logging.vrf.secure_port 整数 指定通过TLS端口发送日志消息 dellos9
logging.vrf.tcp_port 整数 如果未定义secure_port键,则指定通过TCP端口发送日志消息 dellos9
logging.vrf.udp_port 整数 如果未定义TCP和secure_port键,则指定通过UDP端口发送日志消息 dellos9
logging.vrf.state 字符串:absent,present* 如果设置为absent,则删除日志服务器的VRF实例 dellos9
logging.state 字符串:absent,present* 如果设置为absent,则删除日志服务器 dellos6, dellos9, dellos10
console 字典 配置日志到控制台(参见console.* dellos10
console.enable 布尔值 启用/禁用控制台日志 dellos10
console.severity 字符串 配置日志到控制台的最低严重性级别 dellos10
log_file 字典 配置日志到日志文件(参见log_file.* dellos10
log_file.enable 布尔值 启用/禁用日志到日志文件 dellos10
log_file.severity 字符串 配置日志到日志文件的最低严重性级别 dellos10
buffer 整数 指定缓冲日志的严重性级别(0到7) dellos9
console_level 整数 配置控制台日志级别(0到7) dellos9
trap_level 整数 配置syslog服务器的严重性级别(0到7) dellos9
syslog_version 整数 配置syslog版本(0/1) dellos9
monitor 整数 配置终端行日志级别(0到7) dellos9
history 整数 配置syslog历史记录表(0到7) dellos9
history_size 整数 指定历史记录表的大小 dellos9
on 布尔值 如果设置为true,则启用日志到所有支持的目的地 dellos9
extended 布尔值 如果设置为true,则启用扩展日志 dellos9
coredump 字典 配置核心转储日志 dellos9
coredump.server 字典 指定所有服务器详细信息 dellos9
coredump.server.server_ip 字符串(必需) 指定日志服务器的IPv4/IPv6地址 dellos9
coredump.server.username 字符串 指定要配置的用户名 dellos9
coredump.server.password 字符串 指定要配置的密码 dellos9
coredump.server.state 字符串:present,absent* 如果设置为absent,则删除核心转储服务器 dellos9
coredump.stackunit 字典 指定在堆栈单元上启用核心转储的详细信息 dellos9
coredump.stackunit.all 布尔值 在所有堆栈单元上启用核心转储 dellos9
coredump.stackunit.unit_num 整数 指定堆栈单元编号(0到5) dellos9
coredump.stackunit.state 字符串:present,absent* 如果设置为absent,则删除堆栈单元的核心转储 dellos9
source_interface 字符串 配置日志的源接口 dellos6, dellos9, dellos10

注意:星号(*)表示如果未指定则为默认值。

连接变量

Ansible Dell EMC网络角色需要连接信息以建立与您的清单中的节点的通信。这些信息可以存在于Ansible的group_varshost_vars目录中,或者在清单或剧本本身中。

必需 选择 描述
ansible_host 指定连接到远程设备的主机名或地址,通过指定的传输方式
ansible_port 指定用于建立与远程设备连接的端口;如果未指定,则使用ANSIBLE_REMOTE_PORT选项,默认值为22
ansible_ssh_user 指定用于远程设备的CLI登录验证的用户名;如果未指定,则使用ANSIBLE_REMOTE_USER环境变量值
ansible_ssh_pass 指定用于远程设备连接的密码
ansible_become 是,否* 指示模块在远程设备上进入特权模式,然后发送任何命令;如果未指定,则使用ANSIBLE_BECOME环境变量值,设备尝试以非特权模式执行所有命令
ansible_become_method enable, sudo* 指示模块允许指定特权提升的方法;如果未指定,则使用ANSIBLE_BECOME_METHOD环境变量值
ansible_become_pass 如果需要进入远程设备的特权模式,指定要使用的密码;如果ansible_become设置为否,则此键不适用
ansible_network_os dellos6/dellos9/dellos10, null* 加载正确的终端和cliconf插件以与远程设备通信

注意:星号(*)表示如果未指定则为默认值。

依赖关系

dellos-logging角色是基于Ansible核心代码中包含的模块构建的。这些模块是在Ansible 2.2.0版本中添加的。

示例剧本

本示例使用dellos-logging角色完全设置日志服务器。它创建一个包含交换机详细信息和相应变量的hosts文件。hosts文件应定义ansible_network_os变量,并与相应的Dell EMC网络操作系统名称匹配。当dellos_cfg_generate设置为true时,该变量将在build_dir路径中生成配置命令作为.part文件。默认情况下,该变量设置为false。

示例hosts文件

leaf1 ansible_host=<ip_address>

示例host_vars/leaf1

hostname: leaf1
ansible_become: yes
ansible_become_method: xxxxx
ansible_become_pass: xxxxx
ansible_ssh_user: xxxxx
ansible_ssh_pass: xxxxx
ansible_network_os: dellos9
build_dir: ../temp/dellos9

dellos_logging:
  logging:
   - ip: 1.1.1.1
     state: present
   - ip: 2.2.2.2
     secure_port: 1025
     tcp_port: 1024
     udp_port: 2000
     state: present
   - ip: 3.3.3.3
     vrf:
       name: test
       secure_port: 1024
       tcp_port: 1025
       udp_port: 2000
       state: present
     secure_port: 1025
     tcp_port: 2000
     udp_port: 1025
     state: present
 buffer: 5
 console_level: 7
 trap_level: 5
 syslog_version: 5
 history: 4
 history_size: 3
 monitor: 5
 on: true
 extended: true
 coredump:
   server:
     server_ip: 2.2.2.2
     username: u1
     password: pwd
     state: present
   stackunit:
      all: true
      unit_num: 5
      state: present
 source_interface: "fortyGigE 1/9"

简单剧本来设置日志 - leaf.yaml

- hosts: leaf1
  roles:
     - Dell-Networking.dellos-logging

运行

ansible-playbook -i hosts leaf.yaml

(c) 2017 Dell Inc.或其子公司。版权所有。

关于项目

The dellos-logging role facilitates the configuration of logging attributes in devices running Dell EMC Networking Operating Systems.

安装
ansible-galaxy install Dell-Networking.dellos-logging
许可证
apache-2.0
下载
68.2k