acos-events¶
Configure message logging
acos-events Specification¶
Type Intermediate Resource Element Name acos-events Element URI /axapi/v3/acos-events Element Attributes acos-events_attributes Schema acos-events schemaOperations Allowed:
| Operation | Method | URI | Payload | |
|---|---|---|---|---|
Get Object | GET | /axapi/v3/acos-events | acos-events_attributes |
acos-events attributes¶
active-template
Description: active-template is a JSON Block. Please see below for active-template
Type: Object
Refernce Object: /axapi/v3/acos-events/active-template
collector-group-list
Type: List
Refernce Object: /axapi/v3/acos-events/collector-group/{name}
log-properties
Description: log-properties is a JSON Block. Please see below for log-properties
Type: Object
Refernce Object: /axapi/v3/acos-events/log-properties
log-server-list
Type: List
Refernce Object: /axapi/v3/acos-events/log-server/{name}
logdb
Description: logdb is a JSON Block. Please see below for logdb
Type: Object
Refernce Object: /axapi/v3/acos-events/logdb
message-id-list
Type: List
Refernce Object: /axapi/v3/acos-events/message-id/{log-msg}+{message-id-scope-route}
message-info
Description: message-info is a JSON Block. Please see below for message-info
Type: Object
Refernce Object: /axapi/v3/acos-events/message-info
message-selector-list
Type: List
Refernce Object: /axapi/v3/acos-events/message-selector/{name}
rate-limit-local
Description: rate-limit-local is a JSON Block. Please see below for rate-limit-local
Type: Object
Refernce Object: /axapi/v3/acos-events/rate-limit-local
rate-limit-remote
Description: rate-limit-remote is a JSON Block. Please see below for rate-limit-remote
Type: Object
Refernce Object: /axapi/v3/acos-events/rate-limit-remote
statistics
Description: statistics is a JSON Block. Please see below for statistics
Type: Object
Refernce Object: /axapi/v3/acos-events/statistics
template-list
Type: List
Refernce Object: /axapi/v3/acos-events/template/{name}
use-partition
Description: use-partition is a JSON Block. Please see below for use-partition
Type: Object
Refernce Object: /axapi/v3/acos-events/use-partition
rate-limit-remote¶
Specification Type object limit
Description Configure rate limit for logs sent to remote via classic logging config
Type: number
Range: 0-250
Default: 32
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
statistics¶
Specification Type object sampling-enable
Type: Listuuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
statistics_sampling-enable¶
Specification Type list Block object keys counters1
Description ‘all’: all; ‘msg_dropped_malloc_failure’: Messages Dropped due to malloc failure; ‘msg_dropped_no_template’: Messages Dropped, no active template; ‘msg_dropped_selector’: Messages Dropped, selector does not enable msg; ‘msg_dropped_too_long’: Messages Dropped, invalid length; ‘msg_dropped_other’: Messages Dropped, unexpected error;
Type: string
Supported Values: all, msg_sent, msg_sent_logdb, msg_dropped_format_not_defined, msg_dropped_malloc_failure, msg_dropped_no_template, msg_dropped_selector, msg_dropped_too_long, msg_dropped_craft_fail, msg_dropped_local_log_ratelimit, msg_dropped_remote_log_ratelimit, msg_dropped_send_failed, msg_dropped_no_active_member, msg_dropped_route_fail, msg_dropped_other, no_template, msg_dropped_lost_during_config_change, local_enqueue_pass, msg_sent_to_logd, msg_retry_after_socket_fail, msg_sent_direct_syslog, msg_dropped_send_to_logd_fail, msg_dropped_trylock_fail, msg_dropped_remote_cplane_log_ratelimit, msg_dropped_remote_dplane_log_ratelimit, msg_dropped_local_enqueue_failed, msg_dropped_grp_not_used, msg_sent_remote_cplane, msg_dropped_no_template_logd, msg_dropped_lost_during_config_change_logd, msg_dropped_craft_fail_logd, msg_dropped_send_failed_logd, msg_dropped_no_active_member_logd, msg_dropped_other_logd, msg_dropped_invalid_part, acos_evt_test_logs_ticks
use-partition¶
Specification Type object partition-name
Description Select partition name for logging
Type: string
Maximum Length: 14 characters
Maximum Length: 1 characters
Refernce Object: /axapi/v3/partition
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
active-template¶
Specification Type object name
Description Specify the logging template name
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
Refernce Object: /axapi/v3/acos-events/template
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
logdb¶
Specification Type object enable-all
Description Enable logging for all widgets
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
enable-cgn
Description Enable CGN logging
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
enable-fw
Description Enable Firewall logging
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
enable-http-forward-proxy
Description Enable HTTP forward proxy logging
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
enable-link-cost
Description Enable link-cost logging
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
enable-mqtt
Description Enable MQTT logging
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
enable-smtp
Description Enable SMTP logging
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
enable-ssli
Description Enable SSLi logging
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
message-id-list¶
Specification Type list Block object keys log-msg
Description Specify log message-id lineage
Type: string
Maximum Length: 512 characters
Maximum Length: 1 characters
message-id-scope-route
Description ‘all’: Log messages at this level and all sub-trees; ‘node-only’: Log messages at this node only; ‘children-only’: Log messages at all sub-trees only; ‘log-field-only’: This is a log-field (Default);
Type: string
Supported Values: all, node-only, children-only, log-field-only
Default: log-field-only
property
Description: property is a JSON Block. Please see below for message-id-list_property
Type: Object
Refernce Object: /axapi/v3/acos-events/message-id/{log-msg}+{message-id-scope-route}/property
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
message-id-list_property¶
Specification Type object log-route
Description: log-route is a JSON Block. Please see below for message-id-list_property_log-route
Type: Object
Refernce Object: /axapi/v3/acos-events/message-id/{log-msg}+{message-id-scope-route}/property/log-route
severity
Description: severity is a JSON Block. Please see below for message-id-list_property_severity
Type: Object
Refernce Object: /axapi/v3/acos-events/message-id/{log-msg}+{message-id-scope-route}/property/severity
message-id-list_property_log-route¶
Specification Type object log-route-val
Description ‘local-only’: send logs to local-only; ‘remote-only’: send logs to remote-only; ‘local-and-remote’: send logs to both local and remote;
Type: string
Supported Values: local-only, remote-only, local-and-remote
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
message-id-list_property_severity¶
Specification Type object severity-val
Description ‘emergency’: System unusable log messages (severity=0); ‘alert’: Action must be taken immediately (severity=1); ‘critical’: Critical conditions (severity=2); ‘error’: Error conditions (severity=3); ‘warning’: Warning conditions (severity=4); ‘notification’: Normal but significant conditions (severity=5); ‘information’: Informational messages (severity=6); ‘debugging’: Debug level messages (severity=7);
Type: string
Supported Values: emergency, alert, critical, error, warning, notification, information, debugging
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
message-info¶
Specification Type object uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
log-properties¶
Specification Type object add-msgid-in-header
Description Add Message ID in log messages
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
log-server-list¶
Specification Type list Block object keys action
Description ‘enable’: Enable this Logging Server; ‘disable’: Disable this Logging Server;
Type: string
Supported Values: enable, disable
Default: enable
health-check
Description Health Check Monitor (Health monitor name)
Type: string
Maximum Length: 31 characters
Maximum Length: 1 characters
Mutual Exclusion: health-check and health-check-disable are mutually exclusive
Refernce Object: /axapi/v3/health/monitor
health-check-disable
Description Disable configured health check configuration
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
Mutual Exclusion: health-check-disable and health-check are mutually exclusive
host
Description IP Address
Type: string
Format: ipv4-address
name
Description Server Name
Type: string
Format: string-rlx
Maximum Length: 63 characters
Maximum Length: 1 characters
port-list
Type: List
Refernce Object: /axapi/v3/acos-events/log-server/{name}/port/{port-number}+{protocol}
resolve-as
Description ‘resolve-to-ipv4’: Use A Query only to resolve FQDN; ‘resolve-to-ipv6’: Use AAAA Query only to resolve FQDN; ‘resolve-to-ipv4-and-ipv6’: Use A as well as AAAA Query to resolve FQDN;
Type: string
Supported Values: resolve-to-ipv4, resolve-to-ipv6, resolve-to-ipv4-and-ipv6
Default: resolve-to-ipv4
sampling-enable
Type: Listserver-ipv6-addr
Description IPV6 address
Type: string
Format: ipv6-address
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
log-server-list_port-list¶
Specification Type list Block object keys action
Description ‘enable’: enable; ‘disable’: disable;
Type: string
Supported Values: enable, disable
Default: enable
health-check
Description Health Check (Monitor Name)
Type: string
Maximum Length: 31 characters
Maximum Length: 1 characters
Mutual Exclusion: health-check and health-check-disable are mutually exclusive
Refernce Object: /axapi/v3/health/monitor
health-check-disable
Description Disable health check
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
Mutual Exclusion: health-check-disable and health-check are mutually exclusive
port-number
Description Port Number
Type: number
Range: 0-65534
protocol
Description ‘tcp’: TCP Port; ‘udp’: UDP Port;
Type: string
Supported Values: tcp, udp
sampling-enable
Type: Listuser-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
log-server-list_port-list_sampling-enable¶
Specification Type list Block object keys counters1
Description ‘all’: all; ‘msgs_sent’: Number of log messages sent;
Type: string
Supported Values: all, msgs_sent
log-server-list_sampling-enable¶
Specification Type list Block object keys counters1
Description ‘all’: all; ‘msgs_sent’: Number of log messages sent;
Type: string
Supported Values: all, msgs_sent
rate-limit-local¶
Specification Type object limit
Description Configure Rate Limit for Local logs
Type: number
Range: 0-100
Default: 32
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
collector-group-list¶
Specification Type list Block object keys facility
Description ‘local0’: Local use(Default); ‘local1’: Local use; ‘local2’: Local use; ‘local3’: Local use; ‘local4’: Local use; ‘local5’: Local use; ‘local6’: Local use; ‘local7’: Local use; (Facility parameter for syslog messages)
Type: string
Supported Values: local0, local1, local2, local3, local4, local5, local6, local7
Default: local0
format
Description ‘syslog’: syslog is the only format supported at this time;
Type: string
Supported Values: syslog, cef, leef
Default: syslog
health-check
Description Health Check (Monitor Name)
Type: string
Maximum Length: 31 characters
Maximum Length: 1 characters
Refernce Object: /axapi/v3/health/monitor
log-server-list
Type: List
Refernce Object: /axapi/v3/acos-events/collector-group/{name}/log-server/{name}+{port}
name
Description Specify log server group name
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
protocol
Description ‘udp’: use udp syslog protocol to send messages to log collector; ‘tcp’: use tcp syslog protocol to send messages to log collector;
Type: string
Supported Values: udp, tcp
rate
Description Specify the log message rate
Type: number
Range: 0-2147483647
Default: 500
sampling-enable
Type: Listuse-mgmt-port
Description Use managament port to connect to the log servers
Type: boolean
Supported Values: true, false, 1, 0
Default: 0
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
collector-group-list_sampling-enable¶
Specification Type list Block object keys counters1
Description ‘all’: all; ‘msgs_sent’: Number of log messages sent; ‘msgs_rate_limited’: Number of rate limted log messages; ‘msgs_dropped’: Number of messages droppped for other reasons;
Type: string
Supported Values: all, msgs_sent, msgs_rate_limited, msgs_dropped
collector-group-list_log-server-list¶
Specification Type list Block object keys name
Description Member name
Type: string
Format: comp-string
Maximum Length: 63 characters
Maximum Length: 1 characters
Refernce Object: /axapi/v3/acos-events/log-server
port
Description Port number
Type: number
Range: 0-65534
Default: 65534
Refernce Object: /axapi/v3/acos-events/log-server/port
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
template-list¶
Specification Type list Block object keys message-selector-list
Type: List
Refernce Object: /axapi/v3/acos-events/template/{name}/message-selector/{name}
name
Description Specify logging template name
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
template-list_message-selector-list¶
Specification Type list Block object keys collector-group-list
Type: List
Refernce Object: /axapi/v3/acos-events/template/{name}/message-selector/{name}/collector-group/{name}
name
Description Specify the message selector name
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
Refernce Object: /axapi/v3/acos-events/message-selector
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
template-list_message-selector-list_collector-group-list¶
Specification Type list Block object keys name
Description Specify the log server group for receiving log messages
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
Refernce Object: /axapi/v3/acos-events/collector-group
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
message-selector-list¶
Specification Type list Block object keys name
Description Specify message selector name
Type: string
Maximum Length: 63 characters
Maximum Length: 1 characters
rule-list
Type: List
Refernce Object: /axapi/v3/acos-events/message-selector/{name}/rule/{index}
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters
message-selector-list_rule-list¶
Specification Type list Block object keys action
Description ‘send’: log messages selected by this rule will be sent; ‘drop’: log messages selected by this rule will be dropped;
Type: string
Supported Values: send, drop
Default: send
index
Description Specify rule index - rules are applied in numeric order
Type: number
Range: 1-256
message-id
Description Select a specific message by message-id and optionally severity
Type: string
Maximum Length: 128 characters
Maximum Length: 1 characters
message-id-scope
Description ‘all’: Log messages at this level and all sub-trees; ‘node-only’: Log messages at this node only; ‘children-only’: Log messages at all sub-trees;
Type: string
Supported Values: all, node-only, children-only, log-field-only
severity-oper
Description ‘equal-and-higher’: emergency is highest, debugging lowest; ‘equal’: single severity;
Type: string
Supported Values: equal-and-higher, equal
severity-val
Description ‘emergency’: System unusable log messages (severity=0); ‘alert’: Action must be taken immediately (severity=1); ‘critical’: Critical conditions (severity=2); ‘error’: Error conditions (severity=3); ‘warning’: Warning conditions (severity=4); ‘notification’: Normal but significant conditions (severity=5); ‘information’: Informational messages (severity=6); ‘debugging’: Debug level messages (severity=7);
Type: string
Supported Values: emergency, alert, critical, error, warning, notification, information, debugging
user-tag
Description Customized tag
Type: string
Format: string-rlx
Maximum Length: 127 characters
Maximum Length: 1 characters
uuid
Description uuid of the object
Type: string
Maximum Length: 64 characters
Maximum Length: 1 characters