JSON Logs

This feature is only available for BYOC and On-Prem deployment modes.

groundcover utilizes a generic HTTP endpoint for logs in JSON format. This can be useful for integration with 3rd party services and additional collectors, or for importing log files manually.

Sending logs to the endpoint using the data source wizard

In the data sources page, search for the JSON Logs entry. Click on it and open the wizard to see a step-by-step guidance.

Endpoint and ingestion key are mandatory to get started. We highly recommend to add extra attributes to enrich the logs being sent, such as service name, environment, cluster and source.

Once these parameters will be filled, a cURL command will be available in the following format

curl -X POST "https://example.platform.grcv.io/json/logs" \
    -H 'Content-Type: application/x-ndjson' \
    -H 'Authorization: Bearer gcik_AAAAAAAA_BBBBBBBB_CCCCCCCC_DDDDDDDD' \
    -H 'x-groundcover-service-name: test' \
    --data-binary '{"timestamp": "2025-01-01T10:45:32.123456799Z", "msg": "log message"}'

Monitoring your integration

Once the integration is live, you can check the logs in the Logs page or the Explore page, and can set up monitors.