Ingest Amazon GuardDuty security findings

  • Latest Dynatrace
  • How-to guide
  • Preview

This page has been updated to align with the new Grail security events table. For the complete list of updates and actions needed to accomplish the migration, follow the steps in the Grail security table migration guide.

Dynatrace integration with Amazon GuardDuty allows you to unify and contextualize security findings across tools and products, enabling central prioritization, visualization, and automation.

GuardDuty detects suspicious activities in your AWS accounts, workloads, and data. The Dynatrace platform observes the runtime entities related to those AWS resources. Ingesting the detection findings from GuardDuty helps you analyze them in the context of their production apps.

Hub

Explore in Dynatrace Hub

Ingest Amazon GuardDuty detection findings.

How it works

guardduty

  1. Amazon GuardDuty events are sent to Amazon EventBridge, which triggers an AWS Lambda function.

  2. The Lambda function pre-processes the events and sends them to Dynatrace via a dedicated OpenPipeline security ingest endpoint.

  1. The OpenPipeline ingest endpoint processes and maps the data according to the Semantic Dictionary conventions.

  2. Data is stored in a bucket called default_securityevents (for details, see: Built-in Grail buckets).

Prerequisites

See below for the Amazon GuardDuty and Dynatrace requirements.

Amazon GuardDuty requirements

  • Install and configure the latest AWS CLI.

  • Select the AWS region where you want to create the event forwarder.

    1. In a terminal, run:

      aws configure

    2. Set your default region (for example, us-east-1).

Dynatrace requirements

  • Permissions:

    • To query ingested data: storage:security.events:read.

  • Tokens:

Get started

  1. In Dynatrace, open Dynatrace Hub.
  2. Look for Amazon GuardDuty and select Install.
  3. Select Set up, then select Configure new connection.
  4. Follow the on-screen instructions to set up the ingestion.

Monitor data

Once you ingest your Amazon GuardDuty data into Grail, you can monitor your data in the app (in Dynatrace, go to Settings > Amazon GuardDuty).

guardduty

You can view

  • A chart of ingested data from all existing connections over time

  • A table with information about your connections

Visualize and analyze findings

You can create your own dashboards or use our templates to visualize and analyze container vulnerability findings.

  1. In Dynatrace, go to Settings > Amazon GuardDuty.
  2. In the Try our templates section, select the desired dashboard template.

Automate and orchestrate findings

You can create your own workflows or use our templates to automate and orchestrate container vulnerability findings.

  1. In Dynatrace, go to Settings > Amazon GuardDuty.
  2. In the Try our templates section, select the desired workflow template.

Query ingested data

You can query ingested data in Notebooks Notebooks or Security Investigator Security Investigator, using the data format in Semantic Dictionary.

  1. In Dynatrace, go to Settings > Amazon GuardDuty.
  2. Select Open with .
  3. Select Notebooks or Security Investigator.

Evaluate, triage, and investigate detection findings

You can evaluate, triage, and investigate detection findings with the Threats & Exploits app.

  1. In Dynatrace, open Threats & Exploits.
  2. Filter for Provider > Amazon GuardDuty.

Delete connections

To stop sending events to Dynatrace

  1. In Dynatrace, go to Settings > Amazon GuardDuty.
  2. For the connection you want to delete, select Delete.
  3. Follow the on-screen instructions to delete the resources. If you used values different from those specified in the setup dialog, adjust them accordingly.

This removes the Dynatrace resources created for this integration.

FAQ

Which data model is used for the security logs and events coming from Amazon GuardDuty?

Detection finding events store the individual detection findings per affected object represented by an AWS resource.

Which extension fields are added on the events ingested from Amazon GuardDuty?

The aws namespace is added to store AWS-related information with the following fields:

  • aws.account.id

  • aws.region

  • aws.availability_zone

  • aws.resource.type

  • aws.resource.name

What Amazon GuardDuty resource types are supported by Dynatrace for runtime contextualization?

CONTAINER: All the detection findings with a container as the target resource are classified as CONTAINER in object.type, and the container namespace is added with the corresponding fields:

  • container.id

  • container.name

  • container.image.name

  • container.image.version

How do we normalize the risk score for Amazon GuardDuty findings?

  • dt.security.risk.level is mapped from the severity level determined by Amazon GuardDuty mapping of the severity score (detail.severity).

  • dt.security.risk.score is mapped directly from the severity score (detail.severity) set by Amazon GuardDuty.

dt.security.risk.level (mapped from finding.severity)
dt.security.risk.score (mapped from finding.score)
CRITICAL -> CRITICAL
9.0-10.0
HIGH -> HIGH
7.00-8.9
MEDIUM -> MEDIUM
4.0-6.9
LOW -> LOW
1.0-3.9

Consumption

For billing information, see Events powered by Grail.

Use cases

With the ingested data, you can accomplish various use cases, such as

Related tags
Threat Observability