cloud
Open the cloud investigation view: activity by provider, account, region, service or resource, or a dossier for one cloud principal.
Use cloud to investigate the cloud API activity your search matches. You can group the overview by provider, account, region, service, or resource, or set principal= to investigate one identity.
Syntax
... | cloud [<dimension>] [by=<dimension>] [account=<id>] [principal=<id>] [show_mfa=true|false]| Argument | Default | Description |
|---|---|---|
by=<dimension> | service | How to group the overview: provider, account, region, service or resource. |
<dimension> | Positional form of by=, for example cloud region. An unrecognized word is accepted and the default grouping is used. | |
account=<id> | Scope the view to one cloud account: an AWS account id, a GCP project id or an Azure subscription id. No quotes needed. | |
principal=<id> | Open the principal dossier for one identity (an IAM user, role, ARN or federated subject) instead of the overview. | |
show_mfa | false | Add the MFA usage panel. |
Other key=value pairs are accepted and ignored.
Fields the view reads
The view works on OCSF API Activity events (class_uid=6003), such as those from the aws_cloudtrail parser.
| Dimension | OCSF field |
|---|---|
| provider | cloud.provider |
| account | cloud.account.uid |
| region | cloud.region |
| service | api.service.name |
| resource | resources.uid, resources.name, resources.type |
| principal | actor.user.name (type from actor.user.uid) |
| operation | api.operation |
| source address | src_endpoint.ip |
See OCSF field reference for the full paths.
Examples
All CloudTrail activity, grouped by service:
metadata.log_source=aws_cloudtrail | cloudGroup by account, with the MFA panel:
metadata.log_source=aws_cloudtrail | cloud by=account show_mfa=trueWhere in the world one account is active:
metadata.log_source=aws_cloudtrail | cloud region account=234567890123Dossier for one principal in one account:
metadata.log_source=aws_cloudtrail | cloud principal=intern01 account=234567890123Secret reads across all accounts, grouped by resource:
class_uid=6003 api.operation=GetSecretValue | cloud by=resourceNotes
- Filter to cloud API activity first (
metadata.log_source=aws_cloudtrailorclass_uid=6003). The view summarizes what the search matches. cloudopens a view. Use stats when you want rows, for exampleclass_uid=6003 | stats count by cloud.account.uid, api.operation.