Export Logs to Elasticsearch

​

Prerequisites

• Golf Gateway deployed and running
• Elasticsearch cluster (self-hosted or Elastic Cloud)
• API key with write permissions - See Create API keys in Elastic documentation

• write
• create_index
• manage

​

Configure Elasticsearch export

exporters:
  elasticsearch:
    - name: primary-es
      enabled: true
      url: https://elasticsearch.example.com:9200
      api_key: ${ELASTICSEARCH_API_KEY}
      index_prefix: golf-gateway

exporters:
  elasticsearch:
    - name: cloud-es
      enabled: true
      cloud_id: ${ELASTIC_CLOUD_ID}
      api_key: ${ELASTIC_CLOUD_API_KEY}
      index_prefix: golf-gateway

​

Index naming

{index_prefix}-YYYY.MM.DD

​

Index mapping

​

Verify export is working

1. Check gateway health:
   curl http://localhost:8080/health
   # Should show export adapter status
   
2. Generate some traffic, then search in Kibana:
   GET golf-gateway-*/_search
   {
     "query": { "match_all": {} },
     "size": 10
   }
   

​

Troubleshooting

• Connection refused: Verify Elasticsearch URL and network connectivity
• 401 Unauthorized: Check API key has correct permissions
• Index not created: Verify API key has create_index privilege

​

Related guides

• Export Logs to OpenTelemetry - OTLP export
• Set Up Metrics and Monitoring - Health monitoring