﻿---
title: Memcached integration
description: Memcached is an in-memory key-value store for small chunks of arbitrary data (strings, objects) from results of database calls, API calls, or page rendering...
url: https://www.elastic.co/docs/reference/integrations/memcached
---

# Memcached integration


|                                                                                                                                     |                                        |
|-------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------|
| **Version**Version                                                                                                                  | 1.7.1 ([View all](#changelog)View all) |
| **Subscription level**Subscription level[What's this?](https://www.elastic.co/subscriptions)What's this?                            | Basic                                  |
| **Level of support**Level of support[What's this?](https://www.elastic.co/docs/reference/integrations/level-of-support)What's this? | Elastic                                |
| **Ingestion method(s)**Ingestion method(s)                                                                                          | Database                               |


## Overview

Memcached is an in-memory key-value store for small chunks of arbitrary data (strings, objects) from results of database calls, API calls, or page rendering.
As a result of its speed, scalability, simple design, efficient memory management and API support for most popular languages. Memcached is a popular choice for high-performance, large-scale caching use cases.

### Compatibility

The Memcached integration has been tested with 1.5 and 1.6 versions of Memcached. It is expected to work with all versions >= 1.5

## Metrics

The following metrics are fetched from memcached:
**ECS Field Reference**
Refer to this [document](https://www.elastic.co/guide/en/ecs/current/ecs-field-reference.html) for detailed information on ECS fields.
<dropdown title="Exported fields">


  | Field                               | Description                                                                                                                                                                                               | Type             | Unit | Metric Type |
  |-------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------|------|-------------|
  | @timestamp                          | Event timestamp.                                                                                                                                                                                          | date             |      |             |
  | agent.id                            | Unique identifier of this agent (if one exists). Example: For Beats this would be beat.id.                                                                                                                | keyword          |      |             |
  | cloud.account.id                    | The cloud account or organization id used to identify different entities in a multi-tenant environment. Examples: AWS account id, Google Cloud ORG Id, or other unique identifier.                        | keyword          |      |             |
  | cloud.availability_zone             | Availability zone in which this host, resource, or service is located.                                                                                                                                    | keyword          |      |             |
  | cloud.instance.id                   | Instance ID of the host machine.                                                                                                                                                                          | keyword          |      |             |
  | cloud.provider                      | Name of the cloud provider. Example values are aws, azure, gcp, or digitalocean.                                                                                                                          | keyword          |      |             |
  | cloud.region                        | Region in which this host, resource, or service is located.                                                                                                                                               | keyword          |      |             |
  | container.id                        | Unique container id.                                                                                                                                                                                      | keyword          |      |             |
  | data_stream.dataset                 | Data stream dataset.                                                                                                                                                                                      | constant_keyword |      |             |
  | data_stream.namespace               | Data stream namespace.                                                                                                                                                                                    | constant_keyword |      |             |
  | data_stream.type                    | Data stream type.                                                                                                                                                                                         | constant_keyword |      |             |
  | event.dataset                       | Event module                                                                                                                                                                                              | constant_keyword |      |             |
  | event.kind                          | Event kind                                                                                                                                                                                                | constant_keyword |      |             |
  | event.module                        | Event module                                                                                                                                                                                              | constant_keyword |      |             |
  | event.type                          | Event type                                                                                                                                                                                                | constant_keyword |      |             |
  | host.name                           | Name of the host. It can contain what hostname returns on Unix systems, the fully qualified domain name (FQDN), or a name specified by the user. The recommended value is the lowercase FQDN of the host. | keyword          |      |             |
  | memcached.stats.cmd.get             | Number of "get" commands received since server startup not counting if they were successful or not.                                                                                                       | long             |      | counter     |
  | memcached.stats.cmd.set             | Number of "set" commands serviced since server startup.                                                                                                                                                   | long             |      | counter     |
  | memcached.stats.connections.current | Number of open connections to this Memcached server, should be the same value on all servers during normal operation.                                                                                     | long             |      | counter     |
  | memcached.stats.connections.total   | Numer of successful connection attempts to this server since it has been started.                                                                                                                         | long             |      | counter     |
  | memcached.stats.current.bytes       | Number of bytes currently used for caching items.                                                                                                                                                         | long             | byte | gauge       |
  | memcached.stats.evictions           | Number of objects removed from the cache to free up memory for new items when Memcached reaches it's maximum memory setting (limit_maxbytes).                                                             | long             |      | counter     |
  | memcached.stats.get.hits            | Cache HitRate: Its the ratio of number of successful "get" commands (cache hits) since startup and the "cmd_get" value.                                                                                   | long             |      | gauge       |
  | memcached.stats.get.misses          | Number of failed "get" requests as nothing was cached for this key or the cached value was too old.                                                                                                       | long             |      | counter     |
  | memcached.stats.items.current       | Number of items currently in this server's cache.                                                                                                                                                         | long             |      | gauge       |
  | memcached.stats.items.total         | Number of items ever stored on the server. The count increases by every new item stored in the cache.                                                                                                     | long             |      | counter     |
  | memcached.stats.limit.bytes         | Number of bytes the server is allowed to use for storage.                                                                                                                                                 | long             | byte | gauge       |
  | memcached.stats.pid                 | Current process ID of the Memcached task.                                                                                                                                                                 | long             |      |             |
  | memcached.stats.read.bytes          | Total number of bytes received by the server from the network.                                                                                                                                            | long             | byte | counter     |
  | memcached.stats.threads             | Number of threads used by the current Memcached server process.                                                                                                                                           | long             |      | counter     |
  | memcached.stats.uptime.sec          | Memcached server uptime.                                                                                                                                                                                  | long             | s    | gauge       |
  | memcached.stats.written.bytes       | Total number of bytes sent to the network by the server.                                                                                                                                                  | long             | byte | counter     |
  | service.address                     | Address where data about this service was collected from. This should be a URI, network address (ipv4:port or [ipv6]:port) or a resource path (sockets).                                                  | keyword          |      |             |
</dropdown>

<dropdown title="Example">

  ```json
  {
      "@timestamp": "2022-06-24T06:06:06.337Z",
      "agent": {
          "ephemeral_id": "5c05824c-146b-464f-9030-b1e1eccc7c36",
          "id": "a6434521-6e0b-4509-be07-c1591bcfe768",
          "name": "docker-fleet-agent",
          "type": "metricbeat",
          "version": "8.2.0"
      },
      "data_stream": {
          "dataset": "memcached.stats",
          "namespace": "ep",
          "type": "metrics"
      },
      "ecs": {
          "version": "8.11.0"
      },
      "elastic_agent": {
          "id": "a6434521-6e0b-4509-be07-c1591bcfe768",
          "snapshot": false,
          "version": "8.2.0"
      },
      "event": {
          "agent_id_status": "verified",
          "dataset": "memcached.stats",
          "duration": 9903333,
          "ingested": "2022-06-24T06:06:09Z",
          "kind": "metric",
          "module": "memcached"
      },
      "host": {
          "architecture": "x86_64",
          "containerized": false,
          "hostname": "docker-fleet-agent",
          "ip": [
              "192.168.112.7"
          ],
          "mac": [
              "02-42-AC-1F-00-07"
          ],
          "name": "docker-fleet-agent",
          "os": {
              "codename": "focal",
              "family": "debian",
              "kernel": "5.10.104-linuxkit",
              "name": "Ubuntu",
              "platform": "ubuntu",
              "type": "linux",
              "version": "20.04.4 LTS (Focal Fossa)"
          }
      },
      "memcached": {
          "stats": {
              "bytes": {},
              "cmd": {
                  "get": 0,
                  "set": 0
              },
              "connections": {
                  "current": 2,
                  "total": 24
              },
              "current": {
                  "bytes": 0
              },
              "evictions": 0,
              "get": {
                  "hits": 0,
                  "misses": 0
              },
              "items": {
                  "current": 0,
                  "total": 0
              },
              "limit": {
                  "bytes": 67108864
              },
              "pid": 1,
              "read": {
                  "bytes": 12
              },
              "threads": 4,
              "uptime": {
                  "sec": 28
              },
              "written": {
                  "bytes": 2206
              }
          }
      },
      "metricset": {
          "name": "stats",
          "period": 10000
      },
      "service": {
          "address": "tcp://elastic-package-service-memcached-1:11211",
          "type": "memcached"
      },
      "tags": [
          "memcached_stats"
      ]
  }
  ```
</dropdown>


## Screenshots

This integration includes one or more Kibana dashboards that visualizes the data collected by the integration. The screenshots below illustrate how the ingested data is displayed.
<carousel>

  ![Memcached Metrics Overview Dashobard](https://epr.elastic.co/package/memcached/1.7.1/img/Memcached_Metrics_Overview_Dashboard_1.png)

  ![Memcached Metrics Overview Dashobard](https://epr.elastic.co/package/memcached/1.7.1/img/Memcached_Metrics_Overview_Dashboard_2.png)
</carousel>


## Changelog

<dropdown title="Changelog">


  | Version        | Details                                                                                                                                                                                                                                                                                                                                                                                  | Kibana version(s)               |
  |----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
  | **1.7.1**1.7.1 | **Bug fix**Bug fix ([View pull request](https://github.com/elastic/integrations/pull/15258)View pull request)Update the Memcached integration documentation.                                                                                                                                                                                                                             | 8.13.0 or higher9.0.0 or higher |
  | **1.7.0**1.7.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/12468)View pull request)Add support for Kibana `9.0.0`.                                                                                                                                                                                                                                     | 8.13.0 or higher9.0.0 or higher |
  | **1.6.0**1.6.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/10410)View pull request)Add processor support for stats data stream.                                                                                                                                                                                                                        | 8.13.0 or higher                |
  | **1.5.0**1.5.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/10162)View pull request)ECS version updated to 8.11.0. Update the kibana constraint to ^8.13.0. Modified the field definitions to remove ECS fields made redundant by the ecs@mappings component template.                                                                                  | 8.13.0 or higher                |
  | **1.4.0**1.4.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/9869)View pull request)Add global filter on data_stream.dataset to improve performance.                                                                                                                                                                                                     | 8.8.0 or higher                 |
  | **1.3.0**1.3.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/8171)View pull request)Update the package format_version to 3.0.0.                                                                                                                                                                                                                          | 8.8.0 or higher                 |
  | **1.2.0**1.2.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/6983)View pull request)Enable time series data streams for the metrics datasets. This dramatically reduces storage for metrics and is expected to progressively improve query performance. For more details, see https://www.elastic.co/guide/en/elasticsearch/reference/current/tsds.html. | 8.8.0 or higher                 |
  | **1.1.0**1.1.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/6926)View pull request)Add dimensions mapping for TSDB enablement.                                                                                                                                                                                                                          | 8.8.0 or higher                 |
  | **1.0.0**1.0.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/6544)View pull request)Make Memcached GA                                                                                                                                                                                                                                                    | 8.2.0 or higher                 |
  | **0.4.1**0.4.1 | **Bug fix**Bug fix ([View pull request](https://github.com/elastic/integrations/pull/6303)View pull request)Updated documentation                                                                                                                                                                                                                                                        |                                 |
  | **0.4.0**0.4.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/6298)View pull request)Rename ownership from obs-service-integrations to obs-infraobs-integrations                                                                                                                                                                                          |                                 |
  | **0.3.1**0.3.1 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/5123)View pull request)Added categories and/or subcategories.                                                                                                                                                                                                                               |                                 |
  | **0.3.0**0.3.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/5041)View pull request)Update ECS version to 8.5.1                                                                                                                                                                                                                                          |                                 |
  | **0.2.0**0.2.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/4485)View pull request)Added infrastructure category.                                                                                                                                                                                                                                       |                                 |
  | **0.1.0**0.1.0 | **Enhancement**Enhancement ([View pull request](https://github.com/elastic/integrations/pull/1234)View pull request)Initial integration package creation of Memcached                                                                                                                                                                                                                    |                                 |
</dropdown>
