Skip to content

Conversation

@benironside
Copy link
Contributor

@benironside benironside commented Oct 29, 2024

Fixes #6004 by creating a new guide for ingesting third-party alert data from cloud security tool Sysdig Falco, and a new section that contains that guide.

Previews: Ingest Falco data; Ingest third-party cloud security data

@github-actions
Copy link

A documentation preview will be available soon.

Request a new doc build by commenting
  • Rebuild this PR: run docs-build
  • Rebuild this PR and all Elastic docs: run docs-build rebuild

run docs-build is much faster than run docs-build rebuild. A rebuild should only be needed in rare situations.

If your PR continues to fail for an unknown reason, the doc build pipeline may be broken. Elastic employees can check the pipeline status here.

Copy link

@nick-alayil nick-alayil left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall this is an awesome start 🚀 , @benironside. Your efforts are much appreciated 🙏. .

.. `ELASTICSEARCH_HOSTPORT`: your {es} endpoint URL, which can be found under **Connection details** on the upper right of the **Integrations** page in {kib}.
.. `ELASTICSEARCH_INDEX`: the {es} index where you want to store Falco logs.
.. `ELASTICSEARCH_SUFFIX`: The frequency with which you want the {es} index suffix to change. Either `daily`, `monthly`, `annually`, or `none`.
.. `ELASTICSEARCH_USERNAME` and `ELASTICSEARCH_PASSWORD`: the username and password for an account on your {es} instance, with at least the following permissions: Which permissions, Nick?

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can add the following env vars to this list:

ELASTICSEARCH_APIKEY : The preferred way to connect to ES over username and password. Note that support for this env var is added post falcosidekick v2.29, which is the current latest as of writing this. But you could use it with Falcosidekick docker container as docker images with changes are pushed to falcosidekick docker hub much faster.

ELASTICSEARCH_INDEX : The most important thing is to set the index to match logs-falco.alerts-* . This is what the Falco ingest pipeline will match on.

Also worth mentioning that ELASTICSEARCH_USERNAME and ELASTICSEARCH_PASSWORD are only supported in ECH/ESS and not in serverless Elastic Cloud.

I'm intentionally not commenting on ELASTICSEARCH_MUTUALTLS and ELASTICSEARCH_CHECKCERT as I'm not 💯 certain on reasons for using it. I'll check with the team and get back on this.

@benironside
Copy link
Contributor Author

continuing this work in #6046 since it touched related pages

@benironside
Copy link
Contributor Author

closing this issue since the work was added to #6046

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[CloudSecurity][Docs] Streamlined CNCF Falco ingestion documentation

2 participants