This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.

› › ›

Connect to an external monitoring Elasticsearch cluster

edit

Connect to an external monitoring Elasticsearch cluster

edit

If you want to connect to a monitoring Elasticsearch cluster not managed by ECK, you can reference a Secret instead of an Elastisearch cluster in the monitoring section through the secretName attribute:

apiVersion: elasticsearch.k8s.elastic.co/v1
kind: Elasticsearch
metadata:
  name: monitored-sample
  namespace: production
spec:
  version: 8.17.0
  monitoring:
    metrics:
      elasticsearchRefs:
      - secretName: monitoring-metrics-es-ref 
    logs:
      elasticsearchRefs:
      - name: monitoring-logs
        namespace: observability 
        serviceName: monitoring-logs-es-coordinating-nodes 
  nodeSets:
  - name: default
    count: 1
    config:
      node.store.allow_mmap: false

	The `secretName` and `name` attributes are mutually exclusive, you have to choose one or the other.
	The `namespace` and `serviceName` attributes can only be used in conjunction with `name`, not with `secretName`.

The referenced Secret must contain the following connection information:

url: the URL to reach the Elasticsearch cluster
username: the username of the user to be authenticated to the Elasticsearch cluster
password: the password of the user to be authenticated to the Elasticsearch cluster
ca.crt: the contents of the CA certificate in PEM format to secure communication to the Elasticsearch cluster (optional)

apiVersion: v1
kind: Secret
metadata:
  name: monitoring-metrics-es-ref
stringData:
  url: https://mon1.es.abcd-42.xyz.elastic-cloud.com:9243
  username: monitoring-user
  password: REDACTED

The user referenced in the Secret must have been created beforehand.

« Stack Monitoring When to use it »