Forwarding to Elasticsearch
Elasticsearch is a distributed, RESTful search and analytics engine at the heart of the Elastic Stack. Sysdig provides event forwarding to Elasticsearch for versions major or equal to:
- Elasticsearch 7
- Opensearch 1.2
For more information, see How to Ingest Data Into Elasticsearch Service
Prerequisites
Event forwards originate from region-specific IPs. For the full list of outbound IPs by region, see SaaS Regions and IP Ranges. Update your firewall and allow inbound requests from these IP addresses to enable Sysdig to handle event forwarding.
You must have an instance of Elasticsearch running and permissions to access it.
Configure Event Forwarding Integration with Elasticsearch
Log in to Sysdig Secure as
admin
.From the
Settings
module, navigate to theEvents Forwarding
tab.Click the
Add Integration
button.Select
Elasticsearch
from the drop-down menu.Configure the required options:
Integration Name: Define an integration name.
Endpoint: Enter the specific Elasticsearch instance where the data will be saved. For ES Cloud and ES Cloud Enterprise, the endpoint can be found under the Deployments page:
Index Name: Name of the index under which the data will be stored. See also: https://www.elastic.co/blog/what-is-an-elasticsearch-index
Datastreams are currently not supported. Make sure to configure your Elasticsearch index template with the “datastream” option set to off. That way, data will be stored on indices.
Authentication: Basic authentication is the most common format (
username:password
). The given user must have write privileges in Elasticsearch; you can query the available users.Data to Send: Select from the drop-down the types of Sysdig data that should be forwarded. The available list depends on the Sysidg features and products you have enabled.
Allow insecure connections: Used to skip certificate validations when using HTTPS
Toggle the enable switch as necessary. Remember that you will need to “Test Integration” with the button below before enabling the integration.
- Click the
Save
button to save the integration.
Timestamp Mapping
To handle timestamps directly in Elasticsearch, you might want to map them to the appropriate field type. Timestamps have nanosecond resolution in Sysdig and they are available both in epoch timestamp and in RFC 3339 format.
The best approach is using the date_nanos field type and define an explicit mapping in your Elasticsearch instance.
You will need to perform a PUT /<index>/_mapping
API call, with the index you are storing data into, using the following payload:
{
"properties": {
"timestampRFC3339Nano": {
"type": "date_nanos",
"format": "strict_date_optional_time_nanos"
}
}
}
Otherwise, you can do it using the Kibana interface, if you use it.
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.