Skip to content

ObservationRecord

Structure Class

ObservationRecord dataclass

Bases: _SerdeShape

Contains a fact that GuardDuty noted about your environment during an investigation, such as the affected resource, the activity on that resource, or your detection coverage. The record contains at most one of the payload members, the one that matches ObservationType. Indicators can accompany any observation type.

Attributes

account_overview class-attribute instance-attribute
account_overview: AccountOverview | None = ...

Overview information about an account. Set when ObservationType is ACCOUNT_OVERVIEW.

detection_coverage class-attribute instance-attribute
detection_coverage: DetectionCoverage | None = ...

Details about your detection coverage. Set when ObservationType is DETECTION_COVERAGE.

distribution class-attribute instance-attribute
distribution: Distribution | None = ...

A breakdown of findings along one dimension. Set when ObservationType is DISTRIBUTION.

finding_detail class-attribute instance-attribute
finding_detail: FindingDetail | None = ...

Details about a GuardDuty finding. Set when ObservationType is FINDING_DETAIL.

indicators class-attribute instance-attribute
indicators: list[InvestigationIndicator] | None = ...

The threat indicators associated with the observation, such as an IP address, a domain, or a file hash.

kubernetes_activity class-attribute instance-attribute
kubernetes_activity: KubernetesActivity | None = ...

Details about Kubernetes activity. Set when ObservationType is KUBERNETES_ACTIVITY.

malware_scan class-attribute instance-attribute
malware_scan: InvestigationMalwareScan | None = ...

Details about a malware scan. Set when ObservationType is MALWARE_SCAN.

network_activity class-attribute instance-attribute
network_activity: NetworkActivity | None = ...

Details about network activity. Set when ObservationType is NETWORK_ACTIVITY.

observation_type class-attribute instance-attribute
observation_type: str | None = ...

The kind of observation. The value identifies the payload member that can be set: FINDING_DETAIL (FindingDetail), RESOURCE (Resource), NETWORK_ACTIVITY (NetworkActivity), RDS_LOGIN_ACTIVITY (RdsLoginActivity), S3_ACTIVITY (S3Activity), KUBERNETES_ACTIVITY (KubernetesActivity), MALWARE_SCAN (MalwareScan), RELATED_FINDINGS (RelatedFindings), DETECTION_COVERAGE (DetectionCoverage), ACCOUNT_OVERVIEW (AccountOverview), RECOMMENDATION (Recommendations), RUNTIME_SIGNALS (RuntimeSignals), DISTRIBUTION (Distribution), and REPRESENTATIVE_RESOURCE (RepresentativeResources).

rds_login_activity class-attribute instance-attribute
rds_login_activity: RdsLoginActivity | None = ...

Details about login activity on an Amazon RDS database. Set when ObservationType is RDS_LOGIN_ACTIVITY.

recommendations class-attribute instance-attribute
recommendations: list[Recommendation] | None = ...

Recommended actions. Set when ObservationType is RECOMMENDATION.

related_findings class-attribute instance-attribute
related_findings: RelatedFindings | None = ...

Details about findings that are related to the investigated activity. Set when ObservationType is RELATED_FINDINGS.

representative_resources class-attribute instance-attribute
representative_resources: list[RepresentativeFinding] | None = ...

Representative findings for the affected resources, one finding for each resource. Set when ObservationType is REPRESENTATIVE_RESOURCE.

resource class-attribute instance-attribute
resource: InvestigationResource | None = ...

Details about an affected resource. Set when ObservationType is RESOURCE.

runtime_signals class-attribute instance-attribute
runtime_signals: RuntimeSignals | None = ...

A summary of runtime signals. Set when ObservationType is RUNTIME_SIGNALS.

s3_activity class-attribute instance-attribute
s3_activity: S3Activity | None = ...

Details about Amazon S3 activity. Set when ObservationType is S3_ACTIVITY.