nano SIEM
Search Commands

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]
ArgumentDefaultDescription
by=<dimension>serviceHow 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_mfafalseAdd 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.

DimensionOCSF field
providercloud.provider
accountcloud.account.uid
regioncloud.region
serviceapi.service.name
resourceresources.uid, resources.name, resources.type
principalactor.user.name (type from actor.user.uid)
operationapi.operation
source addresssrc_endpoint.ip

See OCSF field reference for the full paths.

Examples

All CloudTrail activity, grouped by service:

metadata.log_source=aws_cloudtrail | cloud

Group by account, with the MFA panel:

metadata.log_source=aws_cloudtrail | cloud by=account show_mfa=true

Where in the world one account is active:

metadata.log_source=aws_cloudtrail | cloud region account=234567890123

Dossier for one principal in one account:

metadata.log_source=aws_cloudtrail | cloud principal=intern01 account=234567890123

Secret reads across all accounts, grouped by resource:

class_uid=6003 api.operation=GetSecretValue | cloud by=resource

Notes

  • Filter to cloud API activity first (metadata.log_source=aws_cloudtrail or class_uid=6003). The view summarizes what the search matches.
  • cloud opens a view. Use stats when you want rows, for example class_uid=6003 | stats count by cloud.account.uid, api.operation.

What's next

  • asset: investigation view for a host, user, IP or MAC
  • stats: aggregate cloud fields yourself
  • timechart: cloud activity over time

On this page