Namespaces
How namespaces keep identity resolution apart across cloud accounts and networks with overlapping private IP ranges.
Set a namespace to keep identity resolution separate across networks that reuse private IP ranges. The same address, such as 10.0.1.5, can identify different machines in different cloud accounts, VPCs, or data centers.
Format
A namespace is either default or <provider>:<suffix>:
provideris one ofaws,gcp,azureoronprem.suffixis non-empty and uses letters, digits,.,_,-and:.
| Example | Meaning |
|---|---|
default | No isolation needed |
aws:123456789012 | One AWS account |
aws:123456789012:vpc-abc | One VPC in an AWS account |
gcp:my-project:prod | A GCP project environment |
azure:<directory-id> | An Azure tenant |
onprem:dc-east | An on-premises data center |
nano rejects any other form.
When to set one
Set a namespace on log sources whose events carry private addresses from more than one network:
| Source | Typical namespace |
|---|---|
| AWS VPC Flow Logs | aws:<account>:<vpc>; private ranges often overlap between VPCs |
| AWS CloudTrail | aws:<account> |
| GCP audit logs | gcp:<project> |
| Azure Activity | azure:<tenant> |
| On-prem firewalls and EDR | onprem:<site> |
Identity providers such as Okta or Microsoft Entra ID don't need one; leave them on default.
Where it's set
A namespace is a property of a log source. Set it when you create or edit the log source in Log Sources.
The namespace is stored with the log source, not on its events: no OCSF field on an event carries it. To tell accounts apart in a search, use the account the parser maps from the event itself: cloud.account.uid for AWS sources, and resources.namespace (the project or subscription ID) for Google Cloud Audit Logs and Azure Activity Log.
Filtering by account
To scope a search to one cloud account, filter on the OCSF account fields:
metadata.log_source=aws_cloudtrail cloud.account.uid="123456789012" | stats count by api.operation, actor.user.name
metadata.log_source=aws_cloudtrail | stats count by cloud.account.uid | sort -count
metadata.log_source=gcp_audit | stats count by resources.namespace | sort -count