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_vars或host_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