Skip to content

Commit 0e76cce

Browse files
wiz: add troubleshooting note in README on event.ingested requirement for standalone Elastic Agent.
Updated the README to include a troubleshooting note explaining that the `event.ingested` ECS field is required for transforms in the Wiz integration. This clarification helps prevent transform-related issues in standalone setups.
1 parent 8bcb8ac commit 0e76cce

File tree

4 files changed

+28
-1
lines changed

4 files changed

+28
-1
lines changed

packages/wiz/_dev/build/docs/README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,17 @@ Agentless deployments are only supported in Elastic Serverless and Elastic Cloud
9898
- Vulnerability data is fetched for the previous day.
9999
- Custom headers are not supported in this integration. Only the standard Authorization header (for example, Bearer token) is used for API requests.
100100

101+
### Troubleshooting
102+
103+
The transforms used in the Wiz integration depend on the presence of the `event.ingested` field to function correctly.
104+
105+
When using Fleet-managed Elastic Agents, the `.fleet_final_pipeline-1` is automatically executed and ensures that the `event.ingested` field is added to all events.
106+
107+
However, when using standalone Elastic Agents, this pipeline is not applied, and the `event.ingested` field is not automatically added.
108+
109+
📌 Action Required (for standalone agents):
110+
You must manually add the `event.ingested` field, preferably via a custom ingest pipeline (e.g., using the @custom pipeline).
111+
101112
## Logs reference
102113

103114
### Audit

packages/wiz/changelog.yml

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,9 @@
11
# newer versions go on top
2+
- version: "3.6.0"
3+
changes:
4+
- description: Add troubleshooting note in README on `event.ingested` requirement for standalone Elastic Agent.
5+
type: enhancement
6+
link: https://github.com/elastic/integrations/pull/14546
27
- version: "3.5.1"
38
changes:
49
- description: Update texts for the input fields helpers.

packages/wiz/docs/README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,17 @@ Agentless deployments are only supported in Elastic Serverless and Elastic Cloud
9898
- Vulnerability data is fetched for the previous day.
9999
- Custom headers are not supported in this integration. Only the standard Authorization header (for example, Bearer token) is used for API requests.
100100

101+
### Troubleshooting
102+
103+
The transforms used in the Wiz integration depend on the presence of the `event.ingested` field to function correctly.
104+
105+
When using Fleet-managed Elastic Agents, the `.fleet_final_pipeline-1` is automatically executed and ensures that the `event.ingested` field is added to all events.
106+
107+
However, when using standalone Elastic Agents, this pipeline is not applied, and the `event.ingested` field is not automatically added.
108+
109+
📌 Action Required (for standalone agents):
110+
You must manually add the `event.ingested` field, preferably via a custom ingest pipeline (e.g., using the @custom pipeline).
111+
101112
## Logs reference
102113

103114
### Audit

packages/wiz/manifest.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
format_version: 3.4.0
22
name: wiz
33
title: Wiz
4-
version: "3.5.1"
4+
version: "3.6.0"
55
description: Collect logs from Wiz with Elastic Agent.
66
type: integration
77
categories:

0 commit comments

Comments
 (0)