|
| 1 | +--- |
| 2 | +title: CloudProcessEvents table in the advanced hunting schema |
| 3 | +description: Learn about the CloudProcessEvents table in the advanced hunting schema, which contains information about process events in multicloud hosted environments. |
| 4 | +search.appverid: met150 |
| 5 | +ms.service: defender-xdr |
| 6 | +ms.subservice: adv-hunting |
| 7 | +f1.keywords: |
| 8 | + - NOCSH |
| 9 | +ms.author: maccruz |
| 10 | +author: schmurky |
| 11 | +ms.localizationpriority: medium |
| 12 | +manager: dansimp |
| 13 | +audience: ITPro |
| 14 | +ms.collection: |
| 15 | +- m365-security |
| 16 | +- tier3 |
| 17 | +ms.custom: |
| 18 | +- cx-ti |
| 19 | +- cx-ah |
| 20 | +ms.topic: reference |
| 21 | +ms.date: 11/11/2024 |
| 22 | +--- |
| 23 | + |
| 24 | +# CloudProcessEvents (Preview) |
| 25 | + |
| 26 | +[!INCLUDE [Microsoft Defender XDR rebranding](../includes/microsoft-defender.md)] |
| 27 | + |
| 28 | +**Applies to:** |
| 29 | +- Microsoft Defender XDR |
| 30 | + |
| 31 | +The `CloudProcessEvents` table in the [advanced hunting](advanced-hunting-overview.md) schema contains information about process events in multicloud hosted environments such as Azure Kubernetes Service, Amazon Elastic Kubernetes Service, and Google Kubernetes Engine. Use this reference to construct queries that return information from this table. |
| 32 | + |
| 33 | +> [!IMPORTANT] |
| 34 | +> Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here. |
| 35 | +
|
| 36 | +For information on other tables in the advanced hunting schema, [see the advanced hunting reference](advanced-hunting-schema-tables.md). |
| 37 | + |
| 38 | +| Column name | Data type | Description | |
| 39 | +|-------------|-----------|-------------| |
| 40 | +| `Timestamp` | `datetime` | Date and time when the event was recorded | |
| 41 | +| `AzureResourceId` | `string` | Unique identifier of the Azure resource associated with the process | |
| 42 | +| `AwsResourceName` | `string` | Unique identifier specific to Amazon Web Services devices, containing the Amazon resource name| |
| 43 | +| `GcpFullResourceName` | `string` | Unique identifier specific to Google Cloud Platform devices, containing a combination of zone and ID for GCP | |
| 44 | +| `ContainerImageName` | `string` | UThe container image name or ID, if it exists | |
| 45 | +| `KubernetesNamespace` | `string` | The Kubernetes namespace name | |
| 46 | +| `KubernetesPodName` | `string` | The Kubernetes pod name | |
| 47 | +| `KubernetesResource` | `string` | Identifier value that includes namespace, resource type and name | |
| 48 | +| `ContainerName` | `string` | Name of the container in Kubernetes or another runtime environment | |
| 49 | +| `ContainerId` | `string` | The container identifier in Kubernetes or another runtime environment| |
| 50 | +| `ActionType` | `string` | Type of activity that triggered the event. See the in-portal schema reference for details.| |
| 51 | +| `FileName` | `string` | Name of the file that the recorded action was applied to | |
| 52 | +| `FolderPath` | `string` | Folder containing the file that the recorded action was applied to| |
| 53 | +| `ProcessId` | `long` | Process ID (PID) of the newly created process | |
| 54 | +| `ProcessName` | `string` | The name of the process | |
| 55 | +| `ParentProcessName` | `string` | The name of the parent process | |
| 56 | +| `ParentProcessId` | `string` | The process ID (PID) of the parent process| |
| 57 | +| `ProcessCommandLine` | `string` | Command line used to create the new process| |
| 58 | +| `ProcessCreationTime` | `datetime` | Date and time the process was created | |
| 59 | +| `ProcessCurrentWorkingDirectory` | `string` | Current working directory of the running process | |
| 60 | +| `AccountName` | `string` | User name of the account | |
| 61 | +| `LogonId` | `long` | Identifier for a logon session. This identifier is unique on the same pod or container between restarts. | |
| 62 | +| `InitiatingProcessId` | `string` | Process ID (PID) of the process that initiated the event | |
| 63 | +| `AdditionalFields` | `string` | Additional information about the event in JSON array format | |
| 64 | + |
| 65 | + |
| 66 | +## Sample queries |
| 67 | + |
| 68 | +You can use this table to get detailed information on processes invoked in a cloud environment. The information is useful in hunting scenarios and can discover threats that can be observed through process details, like malicious processes or command-line signatures. |
| 69 | + |
| 70 | +You can also investigate security alerts provided by Defender for Cloud that make use of the cloud process events data in advanced hunting to understand details in the process tree for processes that include a security alert. |
| 71 | + |
| 72 | +### Process events by command-line arguments |
| 73 | +To hunt for process events including a given term (represented by "x" in the query below) in the command-line arguments: |
| 74 | + |
| 75 | +```kusto |
| 76 | +CloudProcessEvents | where ProcessCommandLine has "x" |
| 77 | +``` |
| 78 | + |
| 79 | +### Rare process events for a pod in a Kuberentes cluster |
| 80 | +To investigate unusual process events invoked as part of a pod in a Kubernetes cluster: |
| 81 | + |
| 82 | +```kusto |
| 83 | +CloudProcessEvents | where AzureResourceId = "x" and KubernetesNamespace = "y" and KubernetesPodName = "z" | summarize count() by ProcessName | top 10 by count_ asc |
| 84 | +``` |
| 85 | + |
| 86 | +## Related topics |
| 87 | + |
| 88 | +- [Advanced hunting overview](advanced-hunting-overview.md) |
| 89 | +- [Learn the query language](advanced-hunting-query-language.md) |
| 90 | +- [Use shared queries](advanced-hunting-shared-queries.md) |
| 91 | +- [Hunt across devices, emails, apps, and identities](advanced-hunting-query-emails-devices.md) |
| 92 | +- [Understand the schema](advanced-hunting-schema-tables.md) |
| 93 | +- [Apply query best practices](advanced-hunting-best-practices.md) |
| 94 | + |
0 commit comments