Compliance events cover findings from compliance rule evaluations and completed compliance scans. Both Dynatrace-generated and third-party ingested data are supported.
Compliance finding
A compliance finding event is generated when an object is evaluated against a compliance rule during a scan. The event contains the results of this evaluation and the compliance status of the given object.
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.
stableDisplay name: Event kindGives 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
stableDisplay name: Event typeThe unique type identifier of a given event.Tags: permission
COMPLIANCE_FINDING
timestamp
timestamp
stableDisplay name: TimestampThe 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
resourcestableDisplay name: AWS account IDThe 12-digit number, such as 123456789012, that uniquely identifies an AWS account.Tags: permissionprimary-field
123456789012
aws.account.name
string
resourceexperimentalDisplay name: AWS account nameName associated with the AWS account.
example.com
azure.tenant.id
string
resourceexperimentalDisplay name: Azure tenant IDUnique, immutable identifier assigned to the Azure tenant.
37c4add3-612a-483d-8b24-cccbb35d3306
azure.tenant.name
string
resourceexperimentalDisplay name: Azure tenant nameName assigned to the Azure tenant.
MyAzureTenant
cloud.provider
string
resourcestableDisplay name: Cloud providerName of the cloud provider.
alibaba_cloud
finding.id
string
stableDisplay name: Finding IDUnique identifier string of a finding.
F-2GJ3LSUM
finding.time.created
timestamp
stableDisplay name: Finding createdTime when the finding was created.
2024-06-24T04:47:21.154000000+02:00
gcp.organization.id
string
resourceexperimentalDisplay name: GCP organization IDUnique, immutable identifier assigned to an organization resource.
123456789012
gcp.organization.name
string
resourceexperimentalDisplay name: GCP organization nameName assigned to the GCP organization.
dynatrace.com
hypervisor.type
string
resourceexperimentalDisplay name: Hypervisor typeVirtualization hypervisor identified. For physical machines, this value is empty.
KVM; VMWARE
k8s.cluster.name
string
resourcestableDisplay name: Kubernetes cluster nameThe 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
resourcestableDisplay name: Kubernetes cluster UIDA 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
resourcestableDisplay name: Kubernetes namespace nameThe name of the namespace that the pod is running in.Tags: permissionprimary-field
default; kube-system
k8s.namespace.uid
string
resourceexperimentalDisplay name: Kubernetes namespace UIDThe UID of the namespace.
bfb1ba44-3bcb-467d-a2dc-188fd74d1db5
k8s.node.name
string
resourcestableDisplay name: Kubernetes node nameName of the node.
cluster-pool-1-c3c7423d-azth
k8s.pod.name
string
resourcestableDisplay name: Kubernetes pod nameThe name of the pod.
checkoutservice-7895755b94-mzs5m
k8s.pod.uid
string
resourcestableDisplay name: Kubernetes pod UIDThe UID of the pod.
275ecb36-5aa8-4c2a-9c47-d8bb681b9aff
k8s.workload.name
string
resourcestableDisplay name: Kubernetes workload nameThe name of the workload.
checkoutservice
k8s.workload.uid
string
resourceexperimentalDisplay name: Kubernetes workload UIDThe UID of the workload.
786a41e4-e673-44bb-bb30-18888f797a2b
vmware.vcenter.name
string
resourceexperimentalDisplay name: VMware vcenter nameName 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
resourceexperimentalProduct name.
Tenable; Snyk
scan.id
string
resourceexperimentalUnique 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
experimentalDisplay name: Compliance rule IDUnique identifier of a compliance rule.
CIS-66577
compliance.rule.metadata_json
string
experimentalAny 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
experimentalDisplay name: Compliance rule severity levelOriginal severity of a compliance rule reported by the vendor.
CRITICAL; HIGH; MEDIUM; LOW
compliance.rule.severity.score
double
experimentalNumber 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
experimentalDisplay name: Compliance rule titleShort 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
experimentalDisplay name: Compliance standard nameName of a compliance standard.
experimentalDisplay name: Compliance standard short nameShort name of a compliance standard.
DISA STIG; NIST
compliance.standard.url
string
experimentalDisplay name: Compliance standard URLLink 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
resourcestableDisplay name: AWS resource nameName 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
resourceexperimentalDisplay name: Azure resource IDA unique, immutable identifier assigned to each Azure cloud resource.
experimentalDisplay name: Compliance result object typeType of the object evaluated for compliance.
k8scluster; k8spod; k8sservice
compliance.result.status.level
string
experimentalDisplay name: Compliance result status levelResult status of the given resource object as evaluated by a scan.
FAILED; PASSED; MANUAL; NOT_RELEVANT
compliance.result.status.score
double
experimentalDisplay name: Compliance result status scoreNumber 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
resourceexperimentalIdentifier 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
resource **deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_deployment instead.**Display name: Cloud applicationAn entity ID of an entity of type CLOUD_APPLICATION.Tags: entity-id
CLOUD_APPLICATION-3AB5BBF3E09A7942
dt.entity.cloud_application_instance
string
resource **deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_pod instead.**Display name: Cloud application instanceAn entity ID of an entity of type CLOUD_APPLICATION_INSTANCE.Tags: entity-id
CLOUD_APPLICATION_INSTANCE-E0D8F94D9065F24F
dt.entity.cloud_application_namespace
string
resource **deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_namespace instead.**Display name: Cloud application namespaceAn 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
resource **deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_cluster instead.**Display name: Kubernetes clusterAn entity ID of an entity of type KUBERNETES_CLUSTER.Tags: entity-id
KUBERNETES_CLUSTER-E0D8F94D9065F24F
dt.entity.kubernetes_node
string
resource **deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_node instead.**Display name: Kubernetes nodeAn entity ID of an entity of type KUBERNETES_NODE.Tags: entity-id
KUBERNETES_NODE-874C66B68CE15070
dt.smartscape_source.id
smartscapeId
resourcestableDisplay name: Smartscape source IDThe 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. 1Tags: smartscape-id
stableDisplay name: Smartscape source typeThe entity type of the entity whose identifier is held in dt.smartscape_source.id.
K8S_CLUSTER; AWS_LAMBDA_FUNCTION
dt.source_entity
string
resource **deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape_source.id instead.**Display name: Source entityThe 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. 2Tags: 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.
Concept
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.
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 when a scan of a configuration dataset against compliance rules is completed.
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
Metadata fields
General event information.
Attribute
Type
Description
Examples
event.kind
string
stableDisplay name: Event kindGives 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
stableDisplay name: Event typeThe unique type identifier of a given event.Tags: permission
COMPLIANCE_SCAN_COMPLETED
timestamp
timestamp
stableDisplay name: TimestampThe 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
resourcestableDisplay name: AWS account IDThe 12-digit number, such as 123456789012, that uniquely identifies an AWS account.Tags: permissionprimary-field
123456789012
aws.account.name
string
resourceexperimentalDisplay name: AWS account nameName associated with the AWS account.
example.com
azure.tenant.id
string
resourceexperimentalDisplay name: Azure tenant IDUnique, immutable identifier assigned to the Azure tenant.
37c4add3-612a-483d-8b24-cccbb35d3306
azure.tenant.name
string
resourceexperimentalDisplay name: Azure tenant nameName assigned to the Azure tenant.
MyAzureTenant
cloud.provider
string
resourcestableDisplay name: Cloud providerName of the cloud provider.
alibaba_cloud
dt.entity.kubernetes_cluster
string
resource **deprecatedThis field is deprecated and will be removed in the future. Use dt.smartscape.k8s_cluster instead.**Display name: Kubernetes clusterAn entity ID of an entity of type KUBERNETES_CLUSTER.Tags: entity-id
KUBERNETES_CLUSTER-E0D8F94D9065F24F
gcp.organization.id
string
resourceexperimentalDisplay name: GCP organization IDUnique, immutable identifier assigned to an organization resource.
123456789012
gcp.organization.name
string
resourceexperimentalDisplay name: GCP organization nameName assigned to the GCP organization.
dynatrace.com
hypervisor.type
string
resourceexperimentalDisplay name: Hypervisor typeVirtualization hypervisor identified. For physical machines, this value is empty.
KVM; VMWARE
k8s.cluster.name
string
resourcestableDisplay name: Kubernetes cluster nameThe 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
resourcestableDisplay name: Kubernetes cluster UIDA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace.
1c7a24c7-ff51-46e0-bcc9-c52637ceec57
object.id
string
resourceexperimentalIdentifier 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.