Security events are a special type of data representing security-relevant data generated by Dynatrace, but also third-party vendors.
The data contains information on vulnerability findings, compliance findings, detection findings, and their corresponding scan events summarizing the scan results.
In the security.events table, the data is separated in different buckets, depending on the origin of the data. For Dynatrace generated data, data is stored in the default_securityevents_builtin bucket, data ingested through the ingest APIs is stored in the default_securityevents bucket, unless rerouted to another bucket in OpenPipeline.
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.
General event information.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableGives 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: |
|
| string | stableThe unique type identifier of a given event.Tags: |
|
| timestamp | stableThe time (UNIX Epoch time in nanoseconds) when the event was ingested. |
|
Information about the finding.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | resource stableThe 12-digit number, such as 123456789012, that uniquely identifies an AWS account.Tags: |
|
| string | resource experimentalName associated with the AWS account. |
|
| string | resource experimentalUnique, immutable identifier assigned to the Azure tenant. |
|
| string | resource experimentalName assigned to the Azure tenant. |
|
| string | resource stableName of the cloud provider. |
|
| string | resource stableAn entity ID of an entity of type CLOUD_APPLICATION.Tags: |
|
| string | resource stableAn entity ID of an entity of type CLOUD_APPLICATION_INSTANCE.Tags: |
|
| string | resource stableAn entity ID of an entity of type CLOUD_APPLICATION_NAMESPACE. A CLOUD_APPLICATION_NAMESPACE is a Kubernetes namespace.Tags: |
|
| string | resource stableAn entity ID of an entity of type KUBERNETES_CLUSTER.Tags: |
|
| string | resource stableAn entity ID of an entity of type KUBERNETES_NODE.Tags: |
|
| string | stableUnique identifier string of a finding. |
|
| timestamp | stableTime when the finding was created. |
|
| string | resource experimentalUnique, immutable identifier assigned to an organization resource. |
|
| string | resource experimentalName assigned to the GCP organization. |
|
| string | resource experimentalVirtualization hypervisor identified. For physical machines, this value is empty. |
|
| string | resource stableThe user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable.Tags: |
|
| string | resource stableA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace. |
|
| string | resource stableThe name of the namespace that the pod is running in.Tags: |
|
| string | resource experimentalThe UID of the namespace. |
|
| string | resource stableName of the node. |
|
| string | resource stableThe name of the pod. |
|
| string | resource stableThe UID of the pod. |
|
| string | resource stableThe name of the workload. |
|
| string | resource experimentalThe UID of the workload. |
|
| string | resource experimentalName of the VMware vCenter server managing the multi-hypervisor environment. |
|
Information about the scan that generated the finding.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | resource experimentalProduct name. |
|
| string | resource experimentalUnique identifier of the scan. |
|
Information about the compliance rule and the compliance standard it belongs to.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalUnique identifier of a compliance rule. |
|
| string | experimentalAny additional metadata associated with the compliance rule. |
|
| string | experimentalOriginal severity of a compliance rule reported by the vendor. |
|
| double | experimentalNumber assigned to the respective severity. For example, 10 corresponds to 'CRITICAL', 7 to 'HIGH', 4 to 'MEDIUM', and 1 to 'LOW'. |
|
| string | experimentalShort description of a compliance rule. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | experimentalName of a compliance standard. |
|
| string | experimentalShort name of a compliance standard. |
|
| string | experimentalLink to the official documentation source about the compliance standard. |
|
Information about the result of the compliance scan.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | resource stableName of the resource for named resources, value of the "Name" tag in AWS for non-named resources (if unavailable, same as aws.resource.id). |
|
| string | resource experimentalA unique, immutable identifier assigned to each Azure cloud resource. |
|
| string | resource experimentalUser-provided name of the Azure cloud resource. |
|
| string | experimentalDetails about the compliance result status. |
|
| string | experimentalReasoning or evidence for the compliance status of this object. |
|
| string | deprecatedName of the object evaluated for compliance. |
|
| string | experimentalType of the object evaluated for compliance. |
|
| string | experimentalResult status of the given resource object as evaluated by a scan. |
|
| double | experimentalNumber assigned to the respective result status. For example, 10 corresponds to 'FAILED', 7 to 'MANUAL', 4 to 'PASSED', and 1 to 'NOT_RELEVANT'. |
|
| string | resource stableThe 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. 1Tags: |
|
| string | resource experimentalIdentifier of the affected object. |
|
| string | resource experimentalName of the affected object. |
|
| string | resource experimentalType of the affected object. |
|
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.
A compliance scan completed event is generated when a scan of a configuration dataset against compliance rules is completed.
General event information.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableGives 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: |
|
| string | stableThe unique type identifier of a given event.Tags: |
|
| timestamp | stableThe time (UNIX Epoch time in nanoseconds) when the event was ingested. |
|
Details about the performed compliance scan.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | resource stableThe 12-digit number, such as 123456789012, that uniquely identifies an AWS account.Tags: |
|
| string | resource experimentalName associated with the AWS account. |
|
| string | resource experimentalUnique, immutable identifier assigned to the Azure tenant. |
|
| string | resource experimentalName assigned to the Azure tenant. |
|
| string | resource stableName of the cloud provider. |
|
| string | resource stableAn entity ID of an entity of type KUBERNETES_CLUSTER.Tags: |
|
| string | resource experimentalUnique, immutable identifier assigned to an organization resource. |
|
| string | resource experimentalName assigned to the GCP organization. |
|
| string | resource experimentalVirtualization hypervisor identified. For physical machines, this value is empty. |
|
| string | resource stableThe user-defined name of the cluster in Dynatrace. Doesn't need to be unique or immutable.Tags: |
|
| string | resource stableA pseudo-ID for the cluster, by default set to the UID of the kube-system namespace. |
|
| string | resource experimentalIdentifier of the affected object. |
|
| string | resource experimentalName of the affected object. |
|
| string | resource experimentalType of the affected object. |
|
| string | resource experimentalProduct name. |
|
| string | resource experimentalProduct vendor. |
|
| string | resource experimentalVersion of the product that performed the scan. |
|
| string | resource experimentalUnique identifier of the scan. |
|
| string | resource experimentalSummary of the scan results. |
|
| timestamp | resource experimentalTime when the scan was completed. |
|
| string | resource experimentalName of the VMware vCenter server managing the multi-hypervisor environment. |
|
A detection finding refers to alerts or detections generated by security tools using correlation algorithms, detection rules, or other analytical methods. They're primarily consumed in the Threats & Exploits app.
Required fields for detection findings to be displayed in the Threats & Exploits app.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableRisk score level, mapped and normalized by Dynatrace. |
|
| string | stableSource of the event, for example, the name of the component or system that generated the event.Tags: |
|
| string | stableThe unique type identifier of a given event.Tags: |
|
| string | stableUnique identifier string of a finding. |
|
| timestamp | stableTime when the finding was created. |
|
| string | stableTitle or summary of the finding. |
|
| string | stableOriginal type of the finding reported by the vendor. |
|
| string | resource experimentalIdentifier of the affected object. Either this or |
|
| string | resource experimentalName of the affected object. Either this or |
|
| string | resource experimentalType of the affected object. |
|
| string | resource experimentalProduct name. |
|
| string | resource experimentalProduct vendor. |
|
Optional fields for detection findings (their existence in an event does not influence if they're displayed in T&E or not).
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableTimestamp of latest activity associated with this finding in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string | stableTimestamp of earliest activity associated with this finding in UTC (given in Grail preferred Linux timestamp nano precision format). |
|
| string[] | experimentalMITRE ATT&CK sub-technique identifiers for this detection, in T{parent}.{sub} dotted format. Independent of threat.attack.technique.ids—no positional alignment is assumed or required. The parent technique is encoded in the sub-technique ID itself, for example, T1059.003 belongs to technique T1059). Omit when no sub-technique information is available; don't use empty string placeholders. Sub-technique names are derivable from IDs via the ATT&CK knowledge base. DQL filter example: array.contains(threat.attack.subtechnique.ids, "T1059.003") |
|
| string[] | experimentalHuman-readable names of the MITRE ATT&CK sub-techniques for this detection. Optional companion to threat.attack.subtechnique.ids. When populated, elements must correspond positionally to threat.attack.subtechnique.ids: names[i] is the display name for ids[i]. No specific ordering of the array is required. Omit when the producing source does not provide sub-technique names; don't use placeholder values. Names can be derived from IDs using the ATT&CK knowledge base. |
|
| string[] | experimentalMITRE ATT&CK tactic identifiers for this detection, in TA-prefixed format. A detection may map to zero or more tactics. Omit or set to an empty array when tactic information is unavailable from the producing source. Tactic names can be derived from IDs using the ATT&CK knowledge base. DQL filter example: array.contains(threat.attack.tactic.ids, "TA0002") |
|
| string[] | experimentalHuman-readable names of the MITRE ATT&CK tactics for this detection. Optional companion to threat.attack.tactic.ids. When populated, elements must correspond positionally to threat.attack.tactic.ids: names[i] is the display name for ids[i]. No specific ordering of the array is required. Omit when the producing source does not provide tactic names; don't use placeholder values. Names can be derived from IDs using the ATT&CK knowledge base. |
|
| string[] | experimentalMITRE ATT&CK technique identifiers for this detection, in T-prefixed format. A detection may map to zero or more techniques. The primary pivot field for ATT&CK heat maps and technique coverage dashboards. Technique names can be derived from IDs using the ATT&CK knowledge base. DQL filter example: array.contains(threat.attack.technique.ids, "T1059") |
|
| string[] | experimentalHuman-readable names of the MITRE ATT&CK techniques for this detection. Optional companion to threat.attack.technique.ids. When populated, elements must correspond positionally to threat.attack.technique.ids: names[i] is the display name for ids[i]. No specific ordering of the array is required. Omit when the producing source does not provide technique names; don't use placeholder values. Names can be derived from IDs using the ATT&CK knowledge base. |
|
| string | experimentalVersion of the MITRE ATT&CK framework used to classify this detection. Useful for audit and reproducibility, since tactic and technique IDs can be added or renumbered across major ATT&CK versions. Some producers don't embed the framework version in their event payloads; omit when version provenance can't be reliably determined. Use bare version numbers without a "v" prefix. |
|
Required fields for detection findings; should be automatically added during ingest via OpenPipeline.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableIn combination with |
|
| string | stableDescribes the general nature of the event, without detailing the event's specific contents. It helps to determine the record type of a raw event.Tags: |
|
| timestamp | stableTime (UNIX Epoch time in nanoseconds) when the event was ingested. |
|
Entity change events are change events at the entity level. An event is generated whenever a vulnerability's affected entity undergoes a status or assessment change.
Query entity status change events.
fetch security.events| filter event.category == "VULNERABILITY_MANAGEMENT"| filter event.type == "VULNERABILITY_STATUS_CHANGE_EVENT"| filter event.level == "ENTITY"
General event information.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableCategorization based on the product and data generating this event. |
|
| array | resource stableList of attributes updated as part of the change event. Values in the list match a |
|
| string | stableHuman-readable description of an event. |
|
| string | experimentalGroup label of an event. |
|
| string | stableGives 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: |
|
| string | resource stableMain reference point to which the event or data is related. Possible values are |
|
| string | stableThe human readable display name of an event type. |
|
| string | stableSource of the event, for example, the name of the component or system that generated the event.Tags: |
|
| string | resource stableName of the product providing this event. |
|
| string | stableStatus of an event as being either Active or Closed. |
|
| string | experimentalAn enum that shows the transition of the above event state. |
|
| string | resource stableType of event trigger (for example, whether it was generated by the system, ingested via API, or triggered by the user). |
|
| string | resource stableID of the user who triggered the event. If generated by Dynatrace, the value is |
|
| string | stableThe unique type identifier of a given event.Tags: |
|
| timestamp | stableThe time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. |
|
Information about the vulnerability at the entity level and its global parent, as well as its previous values.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string[] | resource **deprecatedUse |
|
| string | stableName of the code location where the code-level vulnerability was detected. |
|
| double | stableVulnerability's CVSS base score provided by NVD. |
|
| string | experimentalVulnerability's CVSS vector defined by the provider. |
|
| string | stableVulnerability's CVSS score version. |
|
| string | stableAvailability of the information based on which the assessment of the vulnerability at the entity level has been done. |
|
| string[] | experimentalReasons for the assessment mode at the entity level. |
|
| string | stableAffected entity's reachability by a database. |
|
| string | stablePublic exploits status of the vulnerability at the entity level. |
|
| string | stableInternet exposure status of the vulnerability at the entity level. |
|
| string | stableRisk level, based on Davis Security Score, of the vulnerability at the entity level. |
|
| double | stableDavis Security Score (1-10) calculated by Dynatrace for the vulnerability at the entity level. |
|
| string | stableUsage status of the vulnerable functions causing the vulnerability at the entity level. |
|
| string | stableDescription of the vulnerability. |
|
| string | stableDynatrace user-readable identifier for the vulnerability. |
|
| string | stableExternal provider's unique identifier for the vulnerability. |
|
| string | stableExternal provider's URL to the details page of the vulnerability. |
|
| timestamp | stableTimestamp of when the vulnerability at the entity level was first detected. |
|
| string | stableDynatrace unique identifier for the vulnerability. |
|
| boolean | experimentalIndicates if a vulnerability fix is available. | |
| timestamp | stableTimestamp of the last muted or unmuted action of the vulnerability at the entity level. |
|
| string | experimentalComment for muting or unmuting the vulnerability at entity level. |
|
| string | stableReason for muting or unmuting the vulnerability at the entity level. |
|
| string | stableMute status of the vulnerability at the entity level. |
|
| string | stableUser who last changed the mute status of the vulnerability at the entity level. |
|
| string | stableAvailability of the information based on which the vulnerability assessment has been done. |
|
| string | stableVulnerability's reachability of related data assets by affected entities. |
|
| string | stableVulnerability's internet exposure status. |
|
| string | stableVulnerability's Davis Security Score level. |
|
| double | stableVulnerability's Davis Security Score (1-10) calculated by Dynatrace. |
|
| string | stableUsage status of vulnerable functions causing the vulnerability. Status is |
|
| string | stableTimestamp of when the vulnerability was first detected. |
|
| timestamp | stableTimestamp of the last mute or unmute action of the vulnerability. |
|
| string | stableReason for muting or unmuting the vulnerability. |
|
| string | stableVulnerability's mute status. |
|
| string | stableUser who last changed the vulnerability's mute status. |
|
| string | stableTimestamp of the vulnerability's last resolution status change. |
|
| string | stableCurrent status of the vulnerability. |
|
| string | stableVulnerability's risk score level defined by the provider. For Dynatrace, the Davis Security Score level. |
|
| double | stableVulnerability's risk score defined by the provider. For Dynatrace, Davis Security Score. |
|
| double | stableVulnerability's previous CVSS base score (in case the CVSS base score has changed). |
|
| string | stableVulnerability's previous reachability of related data assets by affected entities (in case the reachability has changed). |
|
| string | stableVulnerability's previous public exploit status (in case the public exploit status has changed). |
|
| string | stableVulnerability's previous internet exposure status (in case the internet exposure status has changed). |
|
| string | stableVulnerability's previous risk level (in case the risk level has changed). |
|
| double | stableVulnerability's previous Davis Security Score (in case Davis Security Score has changed). |
|
| string | stableVulnerability's previous vulnerable function status (in case the vulnerable function status has changed). |
|
| string | experimentalVulnerability’s unique identifier from the previous external provider. |
|
| string | stableTimestamp of the vulnerability's previous mute status (in case the mute status has changed). |
|
| string | experimentalComment of the vulnerability's previous mute status. |
|
| string | stableReason for last muting or unmuting the vulnerability (in case the reason for muting or unmuting the vulnerability has changed). |
|
| string | stableVulnerability's previous mute status (in case the mute status has changed). |
|
| string | stableUser who last changed the vulnerability's mute status (in case the mute status was last changed by a different user). |
|
| string | stableVulnerability's previous resolution status (in case the resolution status has changed). |
|
| string | stableVulnerability's previous risk score level (in case the risk score level has changed). |
|
| double | stableVulnerability's previous risk score (in case the risk score has changed). |
|
| string | experimentalDisplay text of the previous tracking link that was set by the user. |
|
| string | experimentalURL of the previous tracking link that was set by the user. |
|
| string[] | stableList of the vulnerability's CVE IDs. |
|
| string[] | stableList of the vulnerability's CWE IDs. |
|
| string[] | stableList of vulnerability's OWASP IDs. |
|
| string | experimentalDescription of the vulnerability's remediation advice. |
|
| timestamp | stableTimestamp of the last resolution status change of the vulnerability at the entity level. |
|
| string | stableResolution status of the vulnerability at the entity level. |
|
| string | stableVulnerability's risk score level defined by the provider at the entity level. For Dynatrace, the Davis Security Score level. |
|
| string | stableScale by which the risk score and risk score level defined by the provider for the vulnerability at the entity level are measured. |
|
| double | stableRisk score defined by the provider for the vulnerability at the entity level. For Dynatrace, Davis Security Score. |
|
| string | experimentalLevel of the vulnerable component in the technological stack. |
|
| string | stableTechnology of the vulnerable component. |
|
| string | stableTitle of the vulnerability. |
|
| string | experimentalDisplay text of the tracking link that was set by the user. |
|
| string | experimentalURL of the tracking link that was set by the user. |
|
| string | stableClassification of the vulnerability based on commonly accepted enums, such as CWE. |
|
| string | stableDynatrace URL to the details page of the vulnerability. | |
|
Information about the vulnerability's affected entity and related entities.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| array | resource stableIDs of the processes that are currently affected by the vulnerability. |
|
| array | resource stableNames of the processes that are currently affected by the vulnerability. |
|
| string | resource stableID of the affected entity. |
|
| array | resource stableIDs of the management zones to which the affected entity belongs. |
|
| array | resource stableNames of the management zones to which the affected entity belongs. |
|
| string | resource stableName of the affected entity. |
|
| long | resource experimentalNumber of reachable data assets. |
|
| array | resource experimentalIDs of the data assets that can be reached by the affected entities of the vulnerability. |
|
| array | resource experimentalNames of the data assets that can be reached by the affected entities of the vulnerability. |
|
| string | resource stableType of affected entity. |
|
| string | resource stableID of the vulnerable component causing the vulnerability. |
|
| string | resource stableName of the vulnerable component causing the vulnerability. |
|
| string | resource experimentalPackage name of the vulnerable component causing the vulnerability. |
|
| string | resource stableShort name of the vulnerable component causing the vulnerability. |
|
| array | resource stableVulnerable functions detected, containing or causing the vulnerability. |
|
| array | resource experimentalVulnerable functions detected which Dynatrace can't tell if they're in use due to limited insights. |
|
| array | resource experimentalVulnerable functions detected which are not actively used. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | resource stableNumber of related applications. |
|
| array | resource stableIDs of the applications related to the vulnerability's affected entities. |
|
| long | resource stableNumber of related databases. |
|
| array | resource stableIDs of the databases related to the vulnerability's affected entities. |
|
| long | resource stableNumber of related hosts. |
|
| array | resource stableIDs of the hosts related to the vulnerability's affected entities. |
|
| long | resource stableNumber of related Kubernetes clusters. |
|
| array | resource stableIDs of the Kubernetes clusters related to the vulnerability's affected entities. |
|
| long | resource stableNumber of related Kubernetes workloads. |
|
| array | resource stableIDs of the Kubernetes workloads related to the vulnerability's affected entities. |
|
| long | resource stableNumber of related services. |
|
| array | resource stableIDs of the services related to the vulnerability's affected entities. |
|
Entity state events are historical vulnerability states reported at the entity level. The current vulnerability state per entity is exported to Grail regularly.
Query entity state events.
fetch security.events| filter event.category == "VULNERABILITY_MANAGEMENT"| filter event.type == "VULNERABILITY_STATE_REPORT_EVENT"| filter event.level == "ENTITY"
General event information.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableCategorization based on the product and data generating this event. |
|
| string | stableHuman-readable description of an event. |
|
| string | experimentalGroup label of an event. |
|
| string | stableGives 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: |
|
| string | resource stableMain reference point to which the event or data is related. Possible values are |
|
| string | stableThe human readable display name of an event type. |
|
| string | stableSource of the event, for example, the name of the component or system that generated the event.Tags: |
|
| string | resource stableName of the product providing this event. |
|
| string | stableStatus of an event as being either Active or Closed. |
|
| string | stableThe unique type identifier of a given event.Tags: |
|
| timestamp | stableThe time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. |
|
Information about the vulnerability at the entity level and its global vulnerability, with a focus on the affected entities
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string[] | resource **deprecatedUse |
|
| string | stableName of the code location where the code-level vulnerability was detected. |
|
| double | stableVulnerability's CVSS base score provided by NVD. |
|
| string | experimentalVulnerability's CVSS vector defined by the provider. |
|
| string | stableVulnerability's CVSS score version. |
|
| string | stableAvailability of the information based on which the assessment of the vulnerability at the entity level has been done. |
|
| string[] | experimentalReasons for the assessment mode at the entity level. |
|
| string | stableAffected entity's reachability by a database. |
|
| string | stablePublic exploits status of the vulnerability at the entity level. |
|
| string | stableInternet exposure status of the vulnerability at the entity level. |
|
| string | stableRisk level, based on Davis Security Score, of the vulnerability at the entity level. |
|
| double | stableDavis Security Score (1-10) calculated by Dynatrace for the vulnerability at the entity level. |
|
| string | experimentalVulnerability's CVSS vector, adjusted with observability data; this vector is calculated by Dynatrace. |
|
| string | stableUsage status of the vulnerable functions causing the vulnerability at the entity level. |
|
| string | stableDescription of the vulnerability. |
|
| string | stableDynatrace user-readable identifier for the vulnerability. |
|
| string | stableExternal provider's unique identifier for the vulnerability. |
|
| string | stableExternal provider's URL to the details page of the vulnerability. |
|
| string | stableDynatrace unique identifier for the vulnerability. |
|
| boolean | experimentalIndicates if a vulnerability fix is available. | |
| timestamp | stableTimestamp of the last muted or unmuted action of the vulnerability at the entity level. |
|
| string | experimentalComment for muting or unmuting the vulnerability at entity level. |
|
| string | stableReason for muting or unmuting the vulnerability at the entity level. |
|
| string | stableMute status of the vulnerability at the entity level. |
|
| string | stableUser who last changed the mute status of the vulnerability at the entity level. |
|
| string | stableAvailability of the information based on which the vulnerability assessment has been done. |
|
| string | stableVulnerability's reachability of related data assets by affected entities. |
|
| string | stableVulnerability's internet exposure status. |
|
| string | stableVulnerability's Davis Security Score level. |
|
| double | stableVulnerability's Davis Security Score (1-10) calculated by Dynatrace. |
|
| string | stableUsage status of vulnerable functions causing the vulnerability. Status is |
|
| string | stableTimestamp of when the vulnerability was first detected. |
|
| timestamp | stableTimestamp of the last mute or unmute action of the vulnerability. |
|
| string | stableReason for muting or unmuting the vulnerability. |
|
| string | stableVulnerability's mute status. |
|
| string | stableUser who last changed the vulnerability's mute status. |
|
| string | stableTimestamp of the vulnerability's last resolution status change. |
|
| string | stableCurrent status of the vulnerability. |
|
| string | stableVulnerability's risk score level defined by the provider. For Dynatrace, the Davis Security Score level. |
|
| double | stableVulnerability's risk score defined by the provider. For Dynatrace, Davis Security Score. |
|
| string[] | stableList of the vulnerability's CVE IDs. |
|
| string[] | stableList of the vulnerability's CWE IDs. |
|
| string[] | stableList of vulnerability's OWASP IDs. |
|
| string | experimentalDescription of the vulnerability's remediation advice. |
|
| timestamp | stableTimestamp of the last status change of the vulnerability at the entity level. |
|
| string | stableResolution status of the vulnerability at the entity level. |
|
| string | stableVulnerability's risk score level defined by the provider at the entity level. For Dynatrace, the Davis Security Score level. |
|
| string | stableScale by which the risk score and risk score level defined by the provider for the vulnerability at the entity level are measured. |
|
| double | stableRisk score defined by the provider for the vulnerability at the entity level. For Dynatrace, Davis Security Score. |
|
| string | experimentalLevel of the vulnerable component in the technological stack. |
|
| string | stableTechnology of the vulnerable component. |
|
| string | stableTitle of the vulnerability. |
|
| string | experimentalDisplay text of the tracking link that was set by the user. |
|
| string | experimentalURL of the tracking link that was set by the user. |
|
| string | stableClassification of the vulnerability based on commonly accepted enums, such as CWE. |
|
| string | stableDynatrace URL to the details page of the vulnerability. | |
|
This section contains information about the vulnerability's affected and related entities.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| array | resource stableIDs of the processes that are currently affected by the vulnerability. |
|
| array | resource stableNames of the processes that are currently affected by the vulnerability. |
|
| string | resource stableID of the affected entity. |
|
| array | resource stableIDs of the management zones to which the affected entity belongs. |
|
| array | resource stableNames of the management zones to which the affected entity belongs. |
|
| string | resource stableName of the affected entity. |
|
| long | resource experimentalNumber of reachable data assets. |
|
| array | resource experimentalIDs of the data assets that can be reached by the affected entities of the vulnerability. |
|
| array | resource experimentalNames of the data assets that can be reached by the affected entities of the vulnerability. |
|
| string | resource stableType of affected entity. |
|
| string | resource stableID of the vulnerable component causing the vulnerability. |
|
| string | resource stableName of the vulnerable component causing the vulnerability. |
|
| string | resource experimentalPackage name of the vulnerable component causing the vulnerability. |
|
| string | resource stableShort name of the vulnerable component causing the vulnerability. |
|
| array | resource stableVulnerable functions detected, containing or causing the vulnerability. |
|
| array | resource experimentalVulnerable functions detected which Dynatrace can't tell if they're in use due to limited insights. |
|
| array | resource experimentalVulnerable functions detected which are not actively used. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | resource stableNumber of related applications. |
|
| array | resource stableIDs of the applications related to the vulnerability's affected entities. |
|
| array | resource stableNames of the applications related to the vulnerability's affected entities. |
|
| long | resource stableNumber of related databases. |
|
| array | resource stableIDs of the databases related to the vulnerability's affected entities. |
|
| array | resource stableNames of the databases related to the vulnerability's affected entities. |
|
| long | resource stableNumber of related hosts. |
|
| array | resource stableIDs of the hosts related to the vulnerability's affected entities. |
|
| array | resource stableNames of the hosts related to the vulnerability's affected entities. |
|
| long | resource stableNumber of related Kubernetes clusters. |
|
| array | resource stableIDs of the Kubernetes clusters related to the vulnerability's affected entities. |
|
| array | resource stableNames of the Kubernetes clusters related to the vulnerability's affected entities. |
|
| long | resource stableNumber of related Kubernetes workloads. |
|
| array | resource stableIDs of the Kubernetes workloads related to the vulnerability's affected entities. |
|
| array | resource stableNames of the Kubernetes workloads related to the vulnerability's affected entities. |
|
| long | resource stableNumber of related services. |
|
| array | resource stableIDs of the services related to the vulnerability's affected entities. |
|
| array | resource stableNames of the services related to the vulnerability's affected entities. |
|
Vulnerability change events are change events at the vulnerability level. An event is generated whenever a vulnerability undergoes a status or assessment change.
Query vulnerability status change events.
fetch security.events| filter event.category == "VULNERABILITY_MANAGEMENT"| filter event.type == "VULNERABILITY_STATUS_CHANGE_EVENT"
Query vulnerability assessment change events.
fetch security.events| filter event.category == "VULNERABILITY_MANAGEMENT"| filter event.type == "VULNERABILITY_ASSESSMENT_CHANGE_EVENT"
General event information.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableStandard categorization based on the significance of an event according to the ITIL event management standard (previously known as |
|
| array | resource stableList of attributes updated as part of the change event. Values in the list match a |
|
| string | stableHuman-readable description of an event. |
|
| string | experimentalGroup label of an event. |
|
| string | stableGives 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: |
|
| string | resource stableMain reference point to which the event or data is related. Possible values are |
|
| string | stableThe human readable display name of an event type. |
|
| string | stableSource of the event, for example, the name of the component or system that generated the event.Tags: |
|
| string | resource stableName of the product providing this event. |
|
| string | stableStatus of an event as being either Active or Closed. |
|
| string | experimentalAn enum that shows the transition of the above event state. |
|
| string | resource stableType of event trigger (for example, whether it was generated by the system, ingested via API, or triggered by the user). |
|
| string | resource stableID of the user who triggered the event. If generated by Dynatrace, the value is |
|
| string | stableThe unique type identifier of a given event.Tags: |
|
| timestamp | stableThe time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. |
|
Information about the vulnerability and its status and assessment changes.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| double | stableVulnerability's CVSS base score provided by NVD. |
|
| string | experimentalVulnerability's CVSS vector defined by the provider. |
|
| string | stableVulnerability's CVSS score version. |
|
| string | stableAvailability of the information based on which the vulnerability assessment has been done. |
|
| string[] | experimentalReasons for the assessment mode. |
|
| string | stableVulnerability's reachability of related data assets by affected entities. |
|
| string | stableVulnerability's public exploits status. |
|
| string | stableVulnerability's internet exposure status. |
|
| string | stableVulnerability's risk level based on Davis Security Score. |
|
| double | stableVulnerability's Davis Security Score (1-10) calculated by Dynatrace. |
|
| string | stableUsage status of the vulnerable functions causing the vulnerability. |
|
| string | stableDescription of the vulnerability. |
|
| string | stableDynatrace user-readable identifier for the vulnerability. |
|
| string | stableExternal provider's unique identifier for the vulnerability. |
|
| string | stableExternal provider's URL to the details page of the vulnerability. |
|
| timestamp | stableTimestamp of when the vulnerability was first detected. |
|
| string | stableDynatrace unique identifier for the vulnerability. |
|
| boolean | experimentalIndicates if a vulnerability fix is available. | |
| timestamp | stableTimestamp of the vulnerability's last muted or unmuted action. |
|
| string | stableReason for muting or unmuting the vulnerability. |
|
| string | stableVulnerability's mute status. |
|
| string | stableUser who last changed the vulnerability's mute status. |
|
| double | stableVulnerability's previous CVSS base score (in case the CVSS base score has changed). |
|
| string | experimentalVulnerability's previous CVSS vector defined by the provider (in case the CVSS vector has changed). |
|
| string | stableVulnerability's previous reachability of related data assets by affected entities (in case the reachability has changed). |
|
| string | stableVulnerability's previous public exploit status (in case the public exploit status has changed). |
|
| string | stableVulnerability's previous internet exposure status (in case the internet exposure status has changed). |
|
| string | stableVulnerability's previous risk level (in case the risk level has changed). |
|
| double | stableVulnerability's previous Davis Security Score (in case Davis Security Score has changed). |
|
| string | stableVulnerability's previous vulnerable function status (in case the vulnerable function status has changed). |
|
| string | stableTimestamp of the vulnerability's previous mute status (in case the mute status has changed). |
|
| string | stableReason for last muting or unmuting the vulnerability (in case the reason for muting or unmuting the vulnerability has changed). |
|
| string | stableVulnerability's previous mute status (in case the mute status has changed). |
|
| string | stableUser who last changed the vulnerability's mute status (in case the mute status was last changed by a different user). |
|
| string | stableVulnerability's previous resolution status (in case the resolution status has changed). |
|
| string | stableVulnerability's previous risk score level (in case the risk score level has changed). |
|
| double | stableVulnerability's previous risk score (in case the risk score has changed). |
|
| string[] | stableList of the vulnerability's CVE IDs. |
|
| string[] | stableList of the vulnerability's CWE IDs. |
|
| string[] | stableList of vulnerability's OWASP IDs. |
|
| string | experimentalDescription of the vulnerability's remediation advice. |
|
| timestamp | stableTimestamp of the vulnerability's last resolution status change. |
|
| string | stableVulnerability's resolution status. |
|
| string | stableVulnerability's risk score level defined by the provider. For Dynatrace, the Davis Security Score level. |
|
| string | stableScale by which the vulnerability's risk score and risk score level defined by the provider are measured. |
|
| double | stableVulnerability's risk score defined by the provider. For Dynatrace, Davis Security Score. |
|
| string | experimentalLevel of the vulnerable component in the technological stack. |
|
| string | stableTechnology of the vulnerable component. |
|
| string | stableTitle of the vulnerability. |
|
| string | stableClassification of the vulnerability based on commonly accepted enums, such as CWE. |
|
| string | stableDynatrace URL to the details page of the vulnerability. | |
|
Information on changes regarding vulnerability's affected entities.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | resource stableNumber of affected entities. |
|
| long | resource stableNumber of affected hosts. |
|
| long | resource stableNumber of affected nodes. |
|
| long | resource deprecatedNumber of affected entities before the last change event. |
|
| long | resource deprecatedNumber of affected hosts before the last change event. |
|
| long | resource deprecatedNumber of affected Kubernetes nodes before the last change event. |
|
| long | resource deprecatedNumber of affected process groups before the last change event. |
|
| long | resource stableNumber of affected process groups. |
|
| array | resource stableTypes of affected entities. |
|
Information on changes regarding vulnerability's related entities.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | resource stableNumber of related applications. |
|
| long | resource stableNumber of related databases. |
|
| long | resource stableNumber of related hosts. |
|
| long | resource stableNumber of related Kubernetes clusters. |
|
| long | resource stableNumber of related Kubernetes workloads. |
|
| long | resource deprecatedNumber of related databases before the last change event. |
|
| long | resource stableNumber of related services. |
|
Vulnerability state events are historical states at the vulnerability level. The current vulnerability state is exported to Grail regularly.
Query vulnerability state events.
fetch security.events| filter event.category == "VULNERABILITY_MANAGEMENT"| filter event.type == "VULNERABILITY_STATE_REPORT_EVENT"| filter event.level == "VULNERABILITY"
General event information.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableCategorization based on the product and data generating this event. |
|
| string | stableHuman-readable description of an event. |
|
| string | experimentalGroup label of an event. |
|
| string | stableGives 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: |
|
| string | resource stableMain reference point to which the event or data is related. Possible values are |
|
| string | stableThe human readable display name of an event type. |
|
| string | stableSource of the event, for example, the name of the component or system that generated the event.Tags: |
|
| string | resource stableName of the product providing this event. |
|
| string | stableStatus of an event as being either Active or Closed. |
|
| string | stableThe unique type identifier of a given event.Tags: |
|
| timestamp | stableThe time (UNIX Epoch time in nanoseconds) when the event originated, typically when it was created by the source. |
|
Information about the vulnerability.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| string | stableName of the code location where the code-level vulnerability was detected. |
|
| double | stableVulnerability's CVSS base score provided by NVD. |
|
| string | experimentalVulnerability's CVSS vector defined by the provider. |
|
| string | stableVulnerability's CVSS score version. |
|
| string | stableAvailability of the information based on which the vulnerability assessment has been done. |
|
| string[] | experimentalReasons for the assessment mode. |
|
| string | stableVulnerability's reachability of related data assets by affected entities. |
|
| string | stableVulnerability's public exploits status. |
|
| string | stableVulnerability's internet exposure status. |
|
| string | stableVulnerability's risk level based on Davis Security Score. |
|
| double | stableVulnerability's Davis Security Score (1-10) calculated by Dynatrace. |
|
| string | experimentalVulnerability's CVSS vector, adjusted with observability data; this vector is calculated by Dynatrace. |
|
| string | stableUsage status of the vulnerable functions causing the vulnerability. |
|
| string | stableDescription of the vulnerability. |
|
| string | stableDynatrace user-readable identifier for the vulnerability. |
|
| string | stableExternal provider's unique identifier for the vulnerability. |
|
| string | stableExternal provider's URL to the details page of the vulnerability. |
|
| timestamp | stableTimestamp of when the vulnerability was first detected. |
|
| string | stableDynatrace unique identifier for the vulnerability. |
|
| boolean | experimentalIndicates if a vulnerability fix is available. | |
| timestamp | stableTimestamp of the vulnerability's last muted or unmuted action. |
|
| string | stableReason for muting or unmuting the vulnerability. |
|
| string | stableVulnerability's mute status. |
|
| string | stableUser who last changed the vulnerability's mute status. |
|
| string[] | stableList of the vulnerability's CVE IDs. |
|
| string[] | stableList of the vulnerability's CWE IDs. |
|
| string[] | stableList of vulnerability's OWASP IDs. |
|
| string | experimentalDescription of the vulnerability's remediation advice. |
|
| timestamp | stableTimestamp of the vulnerability's last resolution status change. |
|
| string | stableVulnerability's resolution status. |
|
| string | stableVulnerability's risk score level defined by the provider. For Dynatrace, the Davis Security Score level. |
|
| string | stableScale by which the vulnerability's risk score and risk score level defined by the provider are measured. |
|
| double | stableVulnerability's risk score defined by the provider. For Dynatrace, Davis Security Score. |
|
| string | experimentalLevel of the vulnerable component in the technological stack. |
|
| string | stableTechnology of the vulnerable component. |
|
| string | stableTitle of the vulnerability. |
|
| string | stableClassification of the vulnerability based on commonly accepted enums, such as CWE. |
|
| string | stableDynatrace URL to the details page of the vulnerability. | |
|
This section contains information on the vulnerability's affected and related entities.
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | resource stableNumber of affected processes. |
|
| long | resource stableNumber of affected entities. |
|
| long | resource stableNumber of affected hosts. |
|
| long | resource stableNumber of affected nodes. |
|
| array | resource stableIDs of the management zones to which the affected entities belong. |
|
| array | resource stableNames of the management zones to which the affected entities belong. |
|
| long | resource stableNumber of processes of the process group. |
|
| long | resource stableNumber of affected process groups. |
|
| array | resource stableTypes of affected entities. |
|
| array | resource stableDynatrace IDs of the vulnerable components causing the vulnerability. |
|
| array | resource stableNames of the vulnerable components causing the vulnerability. | |
|
| array | resource stableVulnerable functions detected, containing or causing the vulnerability. |
|
| Attribute | Type | Description | Examples |
|---|---|---|---|
| long | resource stableNumber of related applications. |
|
| long | resource stableNumber of related databases. |
|
| long | resource stableNumber of related hosts. |
|
| long | resource stableNumber of related Kubernetes clusters. |
|
| long | resource stableNumber of related Kubernetes workloads. |
|
| long | resource stableNumber of related services. |
|