Compliance events cover findings from compliance rule evaluations and completed compliance scans. Both Dynatrace-generated and third-party ingested data are supported.
Query
Provides an overview of compliance events by event type.
A compliance finding is generated when an object—such as a cloud resource, host, or Kubernetes workload—is evaluated against a single compliance rule during a scan. The event records the rule, the compliance standard it belongs to, and the pass or fail result for that object. Compliance findings are available for both Dynatrace-generated data and findings ingested from third-party tools. A related compliance scan completed event summarizes an entire assessment once all objects have been evaluated.
Query
Lists the most recent compliance findings.
fetch security.events
|filter event.type == "COMPLIANCE_FINDING"
|sort timestamp desc
Counts compliance findings by result status level.
stable Display name: Event kind Gives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. Tags: permission
SECURITY_EVENT
event.type
string
stable Display name: Event type The unique type identifier of a given event. Tags: permission
COMPLIANCE_FINDING
timestamp
timestamp
stable Display name: Timestamp The time (UNIX Epoch time in nanoseconds) when the event was ingested.
1649822520123123123
Finding data fields
Information about the finding.
Attribute
Type
Description
Examples
aws.account.id
string
resourcestable Display name: AWS account ID The 12-digit number, such as 123456789012, that uniquely identifies an AWS account. Tags: permissionprimary-field
123456789012
aws.account.name
string
resourceexperimental Display name: AWS account name Name associated with the AWS account.
example.com
azure.tenant.id
string
resourceexperimental Display name: Azure tenant ID Unique, immutable identifier assigned to the Azure tenant.
37c4add3-612a-483d-8b24-cccbb35d3306
azure.tenant.name
string
resourceexperimental Display name: Azure tenant name Name assigned to the Azure tenant.
MyAzureTenant
cloud.provider
string
resourcestable Display name: Cloud provider Name of the cloud provider.
alibaba_cloud
finding.id
string
stable Display name: Finding ID Unique identifier string of a finding.
F-2GJ3LSUM
finding.time.created
timestamp
stable Display name: Finding created Time when the finding was created.
2024-06-24T04:47:21.154000000+02:00
gcp.organization.id
string
resourceexperimental Display name: GCP organization ID Unique, immutable identifier assigned to an organization resource.
123456789012
gcp.organization.name
string
resourceexperimental Display name: GCP organization name Name assigned to the GCP organization.
dynatrace.com
hypervisor.type
string
resourceexperimental Display name: Hypervisor type Virtualization hypervisor identified. For physical machines, this value is empty.
KVM; VMWARE
k8s.cluster.name
string
resourcestable Display name: Kubernetes cluster name The user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable. Tags: permissionprimary-field
unguard-dev; acme-prod10
k8s.cluster.uid
string
resourcestable Display name: Kubernetes cluster UID A pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
k8s.namespace.name
string
resourcestable Display name: Kubernetes namespace name The name of the namespace that the pod is running in. Tags: permissionprimary-field
default; kube-system
k8s.namespace.uid
string
resourceexperimental Display name: Kubernetes namespace UID The UID of the namespace.
bfb1ba44-3bcb-467d-a2dc-188fd74d1db5
k8s.node.name
string
resourcestable Display name: Kubernetes node name Name of the node.
cluster-pool-1-c3c7423d-azth
k8s.pod.name
string
resourcestable Display name: Kubernetes pod name The name of the pod.
checkoutservice-7895755b94-mzs5m
k8s.pod.uid
string
resourcestable Display name: Kubernetes pod UID The UID of the pod.
275ecb36-5aa8-4c2a-9c47-d8bb681b9aff
k8s.workload.name
string
resourcestable Display name: Kubernetes workload name The name of the workload.
checkoutservice
k8s.workload.uid
string
resourceexperimental Display name: Kubernetes workload UID The UID of the workload.
786a41e4-e673-44bb-bb30-18888f797a2b
vmware.vcenter.name
string
resourceexperimental Display name: VMware vcenter name Name of the VMware vCenter server managing the multi-hypervisor environment.
my-vcenter.lab.dynatrace.org
Scan data fields
Information about the scan that generated the finding.
Attribute
Type
Description
Examples
product.name
string
resourceexperimental Product name.
Tenable; Snyk
scan.id
string
resourceexperimental Unique identifier of the scan.
00000000-0000-0000-0000-000000000000
Rule data fields
Information about the compliance rule and the compliance standard it belongs to.
Attribute
Type
Description
Examples
compliance.rule.id
string
experimental Display name: Compliance rule ID Unique identifier of a compliance rule.
CIS-66577
compliance.rule.metadata_json
string
experimental Any additional metadata associated with the compliance rule.
{\"Section\":\"Kubernetes - v1.9.0\",\"Recommendation ID\":\"1.2.16\",\"Recommendation section\":\"1.2 - Control Plane Components - API Server\", \"Level\":\"L1\"}
compliance.rule.severity.level
string
experimental Display name: Compliance rule severity level Original severity of a compliance rule reported by the vendor.
CRITICAL; HIGH; MEDIUM; LOW
compliance.rule.severity.score
double
experimental Number assigned to the respective severity. For example, 10 corresponds to 'CRITICAL', 7 to 'HIGH', 4 to 'MEDIUM', and 1 to 'LOW'.
10.0; 7.0; 4.0; 1.0
compliance.rule.title
string
experimental Display name: Compliance rule title Short description of a compliance rule.
The Kubernetes Controller Manager must use TLS 1.2, at a minimum, to protect the confidentiality of sensitive data during electronic dissemination
Standard data fields
Attribute
Type
Description
Examples
compliance.standard.name
string
experimental Display name: Compliance standard name Name of a compliance standard.
experimental Display name: Compliance standard short name Short name of a compliance standard.
DISA STIG; NIST
compliance.standard.url
string
experimental Display name: Compliance standard URL Link to the official documentation source about the compliance standard.
DISA STIG; NIST
Result fields
Information about the result of the compliance scan.
Attribute
Type
Description
Examples
aws.resource.name
string
resourcestable Display name: AWS resource name Name of the resource for named resources, value of the "Name" tag in AWS for non-named resources (if unavailable, same as aws.resource.id).
my-ec2-instance
azure.resource.id
string
resourceexperimental Display name: Azure resource ID A unique, immutable identifier assigned to each Azure cloud resource.
experimental Display name: Compliance result object type Type of the object evaluated for compliance.
k8scluster; k8spod; k8sservice
compliance.result.status.level
string
experimental Display name: Compliance result status level Result status of the given resource object as evaluated by a scan.
FAILED; PASSED; MANUAL; NOT_RELEVANT
compliance.result.status.score
double
experimental Display name: Compliance result status score Number assigned to the respective result status. For example, 10 corresponds to 'FAILED', 7 to 'MANUAL', 4 to 'PASSED', and 1 to 'NOT_RELEVANT'.
10.0; 7.0; 4.0; 1.0
object.id
string
resourceexperimental Identifier of the affected object.
Fields added by Dynatrace when the affected entity is resolved in Smartscape. These fields are populated automatically during event ingest and link the finding to the Dynatrace entity model.
Attribute
Type
Description
Examples
dt.entity.cloud_application
string
resourcedeprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_deployment instead. Display name: Cloud application An entity ID of an entity of type CLOUD_APPLICATION. Tags: entity-id
CLOUD_APPLICATION-3AB5BBF3E09A7942
dt.entity.cloud_application_instance
string
resourcedeprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_pod instead. Display name: Cloud application instance An entity ID of an entity of type CLOUD_APPLICATION_INSTANCE. Tags: entity-id
CLOUD_APPLICATION_INSTANCE-E0D8F94D9065F24F
dt.entity.cloud_application_namespace
string
resourcedeprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_namespace instead. Display name: Cloud application namespace An entity ID of an entity of type CLOUD_APPLICATION_NAMESPACE. A CLOUD_APPLICATION_NAMESPACE is a Kubernetes namespace. Tags: entity-id
CLOUD_APPLICATION_NAMESPACE-C61324AA70F57BCB
dt.entity.kubernetes_cluster
string
resourcedeprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_cluster instead. Display name: Kubernetes cluster An entity ID of an entity of type KUBERNETES_CLUSTER. Tags: entity-id
KUBERNETES_CLUSTER-E0D8F94D9065F24F
dt.entity.kubernetes_node
string
resourcedeprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_node instead. Display name: Kubernetes node An entity ID of an entity of type KUBERNETES_NODE. Tags: entity-id
KUBERNETES_NODE-874C66B68CE15070
dt.smartscape_source.id
smartscapeId
resourcestable Display name: Smartscape source ID The ID of the entity considered the source of the signal. The string represents an entity ID of an entity that is stored in the Smartscape storage. 1 Tags: smartscape-id
stable Display name: Smartscape source type The entity type of the entity whose identifier is held in dt.smartscape_source.id.
K8S_CLUSTER; AWS_LAMBDA_FUNCTION
dt.source_entity
string
resourcedeprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape_source.id instead. Display name: Source entity The ID of the entity considered the source of the signal. The string represents an entity ID of an entity that is stored in the classic entity storage. 2 Tags: entity-id
The value of this field will be based on the value of one of the dt.smartscape.<type> fields. That means that the dt.smartscape_source.id and dt.smartscape.<type> fields will both be set to the same ID.
2
The value of this field will be based on the value of one of the dt.entity.<type> fields. This means that the dt.source_entity and dt.entity.<type> fields will both be set to the same ID.
Examples
Security Posture Management — NIST compliance on a Kubernetes node
A compliance finding generated by Dynatrace Security Posture Management, reporting that a Kubernetes node passed a NIST SP 800-53 rule. Dynatrace resolves the node to a Smartscape entity and adds dt.smartscape_source.* during ingest.
A compliance finding reporting that an S3 bucket failed a CIS AWS Foundations Benchmark rule, showing the evaluated object, the rule, the standard it belongs to, and the result status.
A compliance scan completed event is generated once a compliance assessment finishes evaluating all of its objects. It summarizes the scan—the standard evaluated, the tool that ran it, and the scope of the assessment—and complements the individual compliance finding events produced during the same scan. Compliance scan completed events are available for both Dynatrace-generated data (Security Posture Management) and assessments ingested from third-party tools.
Query
Lists the most recent completed compliance scans.
fetch security.events
|filter event.type == "COMPLIANCE_SCAN_COMPLETED"
|sort timestamp desc
Counts completed compliance scans by product.
fetch security.events
|filter event.type == "COMPLIANCE_SCAN_COMPLETED"
|summarize {scans = count()}, by: {product.name}
|sort scans desc
Counts completed compliance scans by cloud provider and product.
stable Display name: Event kind Gives high-level information about what kind of information the event contains without being specific about the contents of the event. It helps to determine the record type of a raw event. Tags: permission
SECURITY_EVENT
event.type
string
stable Display name: Event type The unique type identifier of a given event. Tags: permission
COMPLIANCE_SCAN_COMPLETED
timestamp
timestamp
stable Display name: Timestamp The time (UNIX Epoch time in nanoseconds) when the event was ingested.
1649822520123123123
Scan info fields
Details about the performed compliance scan.
Attribute
Type
Description
Examples
aws.account.id
string
resourcestable Display name: AWS account ID The 12-digit number, such as 123456789012, that uniquely identifies an AWS account. Tags: permissionprimary-field
123456789012
aws.account.name
string
resourceexperimental Display name: AWS account name Name associated with the AWS account.
example.com
azure.tenant.id
string
resourceexperimental Display name: Azure tenant ID Unique, immutable identifier assigned to the Azure tenant.
37c4add3-612a-483d-8b24-cccbb35d3306
azure.tenant.name
string
resourceexperimental Display name: Azure tenant name Name assigned to the Azure tenant.
MyAzureTenant
cloud.provider
string
resourcestable Display name: Cloud provider Name of the cloud provider.
alibaba_cloud
dt.entity.kubernetes_cluster
string
resourcedeprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_cluster instead. Display name: Kubernetes cluster An entity ID of an entity of type KUBERNETES_CLUSTER. Tags: entity-id
KUBERNETES_CLUSTER-E0D8F94D9065F24F
gcp.organization.id
string
resourceexperimental Display name: GCP organization ID Unique, immutable identifier assigned to an organization resource.
123456789012
gcp.organization.name
string
resourceexperimental Display name: GCP organization name Name assigned to the GCP organization.
dynatrace.com
hypervisor.type
string
resourceexperimental Display name: Hypervisor type Virtualization hypervisor identified. For physical machines, this value is empty.
KVM; VMWARE
k8s.cluster.name
string
resourcestable Display name: Kubernetes cluster name The user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable. Tags: permissionprimary-field
unguard-dev; acme-prod10
k8s.cluster.uid
string
resourcestable Display name: Kubernetes cluster UID A pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
object.id
string
resourceexperimental Identifier of the affected object.
A compliance scan completed event generated by Dynatrace Security Posture Management, summarizing the assessment of a Kubernetes cluster against compliance rules.