Skip to content

enhancement(logging)/Add Additional logging configuration Support in Terraform Provider #334

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 4, 2025
Merged

enhancement(logging)/Add Additional logging configuration Support in Terraform Provider #334

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c78afcc
feat: Add persistent logging parameters and rate-limit configuration …
tech-of-all-trades Oct 31, 2025
c61e2e8
feat: Add logging count, persistent storage, and rate-limit support t…
tech-of-all-trades Oct 31, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions docs/data-sources/logging.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,9 +46,24 @@ data "iosxe_logging" "example" {
- `ipv6_hosts_transport` (Attributes List) (see [below for nested schema](#nestedatt--ipv6_hosts_transport))
- `ipv6_vrf_hosts` (Attributes List) (see [below for nested schema](#nestedatt--ipv6_vrf_hosts))
- `ipv6_vrf_hosts_transport` (Attributes List) (see [below for nested schema](#nestedatt--ipv6_vrf_hosts_transport))
- `logging_count` (Boolean) Count every log message and timestamp last occurrence
- `monitor_severity` (String)
- `origin_id_name` (String) Define a unique text string as ID
- `origin_id_type` (String) Use origin hostname/ip/ipv6 as ID
- `persistent_batch` (Number) Batch size for writing to persistent storage
- `persistent_filesize` (Number) Set size of individual log files
- `persistent_immediate` (Boolean) Write log entry to storage immediately (no buffering).
- `persistent_notify` (Boolean) Notify when show logging [persistent] is activated.
- `persistent_protected` (Boolean) Eliminates manipulation on logging-persistent files
- `persistent_size` (Number) Set disk space for writing log messages
- `persistent_threshold` (Number) Setting threshold capacity. When setting circular logging is disabled
- `persistent_url` (String) URL to store logging messages
- `rate_limit_all` (Number) Messages per second
- `rate_limit_all_except_severity` (String) Logging severity level
- `rate_limit_console` (Number) Messages per second
- `rate_limit_console_all` (Number) Messages per second
- `rate_limit_console_all_except_severity` (String) Logging severity level
- `rate_limit_console_except_severity` (String) Logging severity level
- `source_interface` (String)
- `source_interfaces_vrf` (Attributes List) Specify interface and vrf for source address in logging transactions (see [below for nested schema](#nestedatt--source_interfaces_vrf))
- `trap` (Boolean) Set trap server logging level
Expand Down
30 changes: 30 additions & 0 deletions docs/resources/logging.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,11 @@ resource "iosxe_logging" "example" {
]
}
]
logging_count = true
persistent_url = "flash:/local_logging"
persistent_size = 1000000
persistent_filesize = 500000
rate_limit_all = 200
}
```

Expand Down Expand Up @@ -166,10 +171,35 @@ resource "iosxe_logging" "example" {
- `ipv6_hosts_transport` (Attributes List) (see [below for nested schema](#nestedatt--ipv6_hosts_transport))
- `ipv6_vrf_hosts` (Attributes List) (see [below for nested schema](#nestedatt--ipv6_vrf_hosts))
- `ipv6_vrf_hosts_transport` (Attributes List) (see [below for nested schema](#nestedatt--ipv6_vrf_hosts_transport))
- `logging_count` (Boolean) Count every log message and timestamp last occurrence
- `monitor_severity` (String)
- `origin_id_name` (String) Define a unique text string as ID
- `origin_id_type` (String) Use origin hostname/ip/ipv6 as ID
- Choices: `hostname`, `ip`, `ipv6`
- `persistent_batch` (Number) Batch size for writing to persistent storage
- Range: `4096`-`2147483647`
- `persistent_filesize` (Number) Set size of individual log files
- Range: `8192`-`2147483647`
- `persistent_immediate` (Boolean) Write log entry to storage immediately (no buffering).
- `persistent_notify` (Boolean) Notify when show logging [persistent] is activated.
- `persistent_protected` (Boolean) Eliminates manipulation on logging-persistent files
- `persistent_size` (Number) Set disk space for writing log messages
- Range: `16384`-`2147483647`
- `persistent_threshold` (Number) Setting threshold capacity. When setting circular logging is disabled
- Range: `1`-`99`
- `persistent_url` (String) URL to store logging messages
- `rate_limit_all` (Number) Messages per second
- Range: `1`-`10000`
- `rate_limit_all_except_severity` (String) Logging severity level
- Choices: `alerts`, `critical`, `debugging`, `emergencies`, `errors`, `informational`, `notifications`, `warnings`
- `rate_limit_console` (Number) Messages per second
- Range: `1`-`10000`
- `rate_limit_console_all` (Number) Messages per second
- Range: `1`-`10000`
- `rate_limit_console_all_except_severity` (String) Logging severity level
- Choices: `alerts`, `critical`, `debugging`, `emergencies`, `errors`, `informational`, `notifications`, `warnings`
- `rate_limit_console_except_severity` (String) Logging severity level
- Choices: `alerts`, `critical`, `debugging`, `emergencies`, `errors`, `informational`, `notifications`, `warnings`
- `source_interface` (String)
- `source_interfaces_vrf` (Attributes List) Specify interface and vrf for source address in logging transactions (see [below for nested schema](#nestedatt--source_interfaces_vrf))
- `trap` (Boolean) Set trap server logging level
Expand Down
5 changes: 5 additions & 0 deletions examples/resources/iosxe_logging/resource.tf
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,4 +120,9 @@ resource "iosxe_logging" "example" {
]
}
]
logging_count = true
persistent_url = "flash:/local_logging"
persistent_size = 1000000
persistent_filesize = 500000
rate_limit_all = 200
}
53 changes: 53 additions & 0 deletions gen/definitions/logging.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -234,6 +234,59 @@ attributes:
- yang_name: profile
example: PROF1
exclude_test: true
- yang_name: count
tf_name: logging_count
example: true
- yang_name: persistent/url
example: flash:/local_logging
- yang_name: persistent/size
example: 1000000
- yang_name: persistent/filesize
example: 500000
- yang_name: persistent/batch
example: 4096
exclude_test: true
- yang_name: persistent/threshold
example: 50
exclude_test: true
- yang_name: persistent/immediate
example: true
exclude_test: true
- yang_name: persistent/notify
example: true
exclude_test: true
- yang_name: persistent/protected
example: true
exclude_test: true
- yang_name: rate-limit-config/config-options/common-case/common-config/rate-limit/all/common-options/range
xpath: rate-limit-config/common-config/rate-limit/all/common-options/range
tf_name: rate_limit_all
example: 200
- yang_name: rate-limit-config/config-options/common-case/common-config/rate-limit/all/common-options/except/range
xpath: rate-limit-config/common-config/rate-limit/all/common-options/except/range
tf_name: rate_limit_all_except_severity
example: warnings
exclude_test: true
- yang_name: rate-limit-config/config-options/common-case/common-config/rate-limit/console/common-options/range
xpath: rate-limit-config/common-config/rate-limit/console/common-options/range
tf_name: rate_limit_console
example: 100
exclude_test: true
- yang_name: rate-limit-config/config-options/common-case/common-config/rate-limit/console/common-options/except/range
xpath: rate-limit-config/common-config/rate-limit/console/common-options/except/range
tf_name: rate_limit_console_except_severity
example: errors
exclude_test: true
- yang_name: rate-limit-config/config-options/common-case/common-config/rate-limit/console/all/common-options/range
xpath: rate-limit-config/common-config/rate-limit/console/all/common-options/range
tf_name: rate_limit_console_all
example: 150
exclude_test: true
- yang_name: rate-limit-config/config-options/common-case/common-config/rate-limit/console/all/common-options/except/range
xpath: rate-limit-config/common-config/rate-limit/console/all/common-options/except/range
tf_name: rate_limit_console_all_except_severity
example: critical
exclude_test: true

test_prerequisites:
- path: Cisco-IOS-XE-native:native/vrf/definition=VRF1
Expand Down
60 changes: 60 additions & 0 deletions internal/provider/data_source_iosxe_logging.go
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

10 changes: 10 additions & 0 deletions internal/provider/data_source_iosxe_logging_test.go
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading