Settings API - Log ingest rules schema table
Log ingest rules (builtin:logmonitoring.log-storage-settings)
You can include and exclude specific log sources for analysis by Dynatrace Log Monitoring. The ingest of log records is based on below rules that use matchers like log path, log levels, process groups, k8s specific selectors and more.
To ingest logs, create a new ingest rule. Use suggestions or type in the log source. You can review available log sources on the Process Group Instance screens. You need to define a custom log source if the required log source is not listed.
Schema ID
Schema groups
Scope
builtin:logmonitoring.log-storage-settings
group:log-monitoring
group:log-monitoring.ingest-and-processing
HOST
- HostHOST_GROUP
- Host Groupenvironment
GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:logmonitoring.log-storage-settings |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:logmonitoring.log-storage-settings | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:logmonitoring.log-storage-settings |
Authentication
To execute this request, you need an access token with Read settings (settings.read
) scope. To learn how to obtain and use it, see Tokens and authentication.
Parameters
Property
Type
Description
Required
Active
enabled
boolean
-
required
Name
config-item-title
text
-
required
Send to storage
send-to-storage
boolean
If true
matching logs will be included in storage. If false
matching logs will be excluded from storage.
required
The Matcher
object
Property
Type
Description
Required
Attribute
attribute
enum
dt.entity.process_group
log.source
log.source.origin
log.content
loglevel
host.tag
k8s.container.name
k8s.namespace.name
k8s.deployment.name
container.name
dt.entity.container_group
process.technology
winlog.eventid
winlog.provider
winlog.task
winlog.opcode
required
Operator
operator
enum
MATCHES
required
values
set
-
required