Skip to content

The cross-harness, self-improving memory layer for AI agents. Join our community: https://discord.com/invite/zdNChS2fBu

Add Falcon HEC forward GitHub Actions reference workflow.

Ayush7614f970938ff2fb
diff --git a/cli/beacon/README.md b/cli/beacon/README.md
index ad9501bd..5b47f486 100644
--- a/cli/beacon/README.md
+++ b/cli/beacon/README.md
@@ -377,7 +377,8 @@ See [`examples/github-actions/claude-code-telemetry.yml`](../../examples/github-
[`examples/github-actions/codex-action-session.yml`](../../examples/github-actions/codex-action-session.yml),
[`examples/github-actions/s3-upload-telemetry.yml`](../../examples/github-actions/s3-upload-telemetry.yml),
[`examples/github-actions/gcs-upload-telemetry.yml`](../../examples/github-actions/gcs-upload-telemetry.yml),
-and [`examples/github-actions/splunk-forward-telemetry.yml`](../../examples/github-actions/splunk-forward-telemetry.yml)
+[`examples/github-actions/splunk-forward-telemetry.yml`](../../examples/github-actions/splunk-forward-telemetry.yml),
+and [`examples/github-actions/falcon-forward-telemetry.yml`](../../examples/github-actions/falcon-forward-telemetry.yml)
for complete reference workflows.
## Wazuh
diff --git a/docs/log-forwarding/ci-telemetry-exports.mdx b/docs/log-forwarding/ci-telemetry-exports.mdx
index 0a5e1e08..8e445bb0 100644
--- a/docs/log-forwarding/ci-telemetry-exports.mdx
+++ b/docs/log-forwarding/ci-telemetry-exports.mdx
@@ -96,9 +96,10 @@ jobs:
upload-artifact: "true"
```
-See the sample workflow:
+See the sample workflows:
- [Splunk forward telemetry workflow](https://github.com/Asymptote-Labs/agent-beacon/blob/main/examples/github-actions/splunk-forward-telemetry.yml)
+- [Falcon forward telemetry workflow](https://github.com/Asymptote-Labs/agent-beacon/blob/main/examples/github-actions/falcon-forward-telemetry.yml)
For Falcon LogScale HEC, set `BEACON_CI_FALCON_HEC_TOKEN` and use `forward: falcon`.
diff --git a/examples/github-actions/claude-code-telemetry.yml b/examples/github-actions/claude-code-telemetry.yml
index fd551596..93f59f9a 100644
--- a/examples/github-actions/claude-code-telemetry.yml
+++ b/examples/github-actions/claude-code-telemetry.yml
@@ -43,9 +43,12 @@ jobs:
command: claude --print "Summarize the changes in this pull request"
# Optional: forward to a customer-managed SIEM before teardown.
# Requires a Beacon release that includes ci exec --forward.
- # See examples/github-actions/splunk-forward-telemetry.yml.
+ # See examples/github-actions/splunk-forward-telemetry.yml or
+ # examples/github-actions/falcon-forward-telemetry.yml.
# forward: splunk
# forward-endpoint: https://splunk.example:8088/services/collector
+ # forward: falcon
+ # forward-endpoint: https://cloud.us-1.humio.com/api/v1/ingest/hec
# Optional: upload the completed runtime JSONL to object storage.
# Supported values: s3, gcs, or s3,gcs.
# upload: s3
diff --git a/examples/github-actions/falcon-forward-telemetry.yml b/examples/github-actions/falcon-forward-telemetry.yml
new file mode 100644
index 00000000..f7513d14
--- /dev/null
+++ b/examples/github-actions/falcon-forward-telemetry.yml
@@ -0,0 +1,38 @@
+# Reference workflow for testing Agent Beacon CI telemetry with direct Falcon
+# LogScale HEC forwarding. Copy this file to .github/workflows/ in a test
+# repository and update the Falcon endpoint, secret names, and action ref.
+#
+# This file lives under examples/ (not .github/workflows/) so it is a reference
+# only and does not run in this repository.
+# Replace <tag> with the Beacon release tag you want to run (v0.0.39 or newer).
+
+name: Test Agent Beacon Falcon forward
+
+on:
+ workflow_dispatch:
+
+permissions:
+ contents: read
+
+jobs:
+ beacon-falcon-forward:
+ runs-on: ubuntu-latest
+ # Keep the Falcon token at the job level so Beacon can forward events
+ # without exposing the secret to the Claude child process.
+ env:
+ BEACON_CI_FALCON_HEC_TOKEN: ${{ secrets.FALCON_HEC_TOKEN }}
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Install Claude Code
+ run: npm install -g @anthropic-ai/claude-code
+
+ - name: Run Agent Beacon with Falcon forwarding
+ uses: asymptote-labs/agent-beacon@<tag>
+ env:
+ ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+ with:
+ command: claude --print "Say hello from Agent Beacon CI telemetry"
+ forward: falcon
+ forward-endpoint: https://cloud.us-1.humio.com/api/v1/ingest/hec
+ upload-artifact: "true"