Skip to main content
The Memcached integration requires CXDOT Collector 1.4.0 or greater. Memcached is a distributed memory object caching system. Use the Memcached CXDOT Collector integration with the CXDOT Collector to collect cache, operation, and connection metrics from Memcached servers running in your environment. The integration supports Memcached 1.6 or greater.

Supported telemetry types

The integration supports these telemetry types:

Prerequisites

The integration has the following prerequisites:
  • A Memcached server that listens on a TCP port the CXDOT Collector can reach. Unix domain sockets aren’t supported.
  • A Memcached server that accepts unauthenticated connections. The integration uses the plain-text stats command and doesn’t support servers that require SASL authentication.

Configure

The Memcached integration is enabled by default. You can configure targets either by annotating pods in your Kubernetes cluster or by listing static endpoints in your Helm values. To configure the integration, follow these steps:
  1. To collect from Memcached pods in Kubernetes, add a CXDOT integration annotation to the pod template. The annotation key must end with the container name. For example, add the following annotation to your Memcached workload:
    The Collector replaces ${target.host} with the pod IP address and ${target.port.memcached} with the container port named memcached. The Collector also discovers Memcached pods that carry the app.kubernetes.io/name: memcached label and listen on port 11211. A CXDOT integration annotation takes precedence over the label for its container. To stop collecting from a container, set memcached: {enabled: false} in the annotation. For more information, see autodiscovery.
  2. Optional: To collect from Memcached servers outside your Kubernetes cluster, configure static targets. For example, add the following to the values.yaml for your CXDOT Collector Helm chart:
    When you configure static targets, this integration instance collects from exactly those targets instead of discovered targets.
  3. Optional: Configure a second integration instance to collect from both discovered pods and static targets. For example, add the following to the values.yaml for your CXDOT Collector Helm chart:
    The memcached/external key defines a named instance for the static targets. The bare memcached key continues to discover pods.
  4. Optional: Disable the integration when you don’t want the CXDOT Collector to collect Memcached metrics. For example, add the following to the values.yaml for your CXDOT Collector Helm chart:

Validate

To validate the integration, follow these steps:
  1. In Live Telemetry Analyzer, filter for __name__=cxdot.integration.target.health and cxdot.integration.name=memcached. Confirm that each expected target reports 1. A value of 1 means that the stats command succeeded. A value of 0 means that it failed. Use the server.address and server.port attributes to identify each target.
  2. In Metrics Explorer, run the following query:
    Confirm that the query returns one time series per target.

Configuration reference

Configure one Memcached integration instance with the following settings. In Helm values, place these settings under collection.cxdot.integrations.memcached. In a Collector configuration file, place them under cxdot.integrations.memcached.

Optional settings

  • enabled Type: boolean. Optional. Default: true. Whether to run the Memcached integration. If true, the Collector collects Memcached metrics. If false, the Collector doesn’t run this integration.
  • endpoints Type: array of object. Optional. Default: []. Memcached targets. Each entry’s endpoint is host:port, for example, memcached.default.svc:11211. When this list isn’t empty, the integration collects from exactly these targets instead of discovered targets. The integration uses the plain-text stats command and doesn’t support servers that require authentication.
  • endpoints[].endpoint Type: string. Required. Memcached target in host:port format.
  • collection_interval Type: duration. Optional. Default: 10s. Time between metric collections from each Memcached target.
  • timeout Type: duration. Optional. Default: 10s. Maximum time to wait for each Memcached metric collection.