---
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
products:
- Elastic integrations
applies_to:
- Serverless Observability projects: Generally available
- Serverless Security projects: Generally available
- Elastic Stack: Generally available since 9.0
---
# Memcached integration
| | |
|-------------------------------------------------------------------------------------------------|--------------------------------|
| **Version** | 1.8.0 ([View all](#changelog)) |
| **Subscription level**[What's this?](https://www.elastic.co/subscriptions) | Basic |
| **Developed by**[What's this?](https://www.elastic.co/docs/reference/integrations/developed-by) | Elastic |
| **Ingestion method(s)** | Database |
| **Minimum Kibana version(s)** | 9.0.08.13.0 |
## 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.
| 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 | | |
```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"
]
}
```
## 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.
## Changelog
| Version | Details | Minimum Kibana version |
|-----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------|
| **1.8.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/17269))Expose condition for metrics | 9.0.08.13.0 |
| **1.7.1** | **Bug fix** ([View pull request](https://github.com/elastic/integrations/pull/15258))Update the Memcached integration documentation. | 9.0.08.13.0 |
| **1.7.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/12468))Add support for Kibana `9.0.0`. | 9.0.08.13.0 |
| **1.6.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/10410))Add processor support for stats data stream. | 8.13.0 |
| **1.5.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/10162))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 |
| **1.4.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/9869))Add global filter on data_stream.dataset to improve performance. | 8.8.0 |
| **1.3.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/8171))Update the package format_version to 3.0.0. | 8.8.0 |
| **1.2.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/6983))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](https://www.elastic.co/guide/en/elasticsearch/reference/current/tsds.html). | 8.8.0 |
| **1.1.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/6926))Add dimensions mapping for TSDB enablement. | 8.8.0 |
| **1.0.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/6544))Make Memcached GA | 8.2.0 |
| **0.4.1** | **Bug fix** ([View pull request](https://github.com/elastic/integrations/pull/6303))Updated documentation | 8.2.0 |
| **0.4.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/6298))Rename ownership from obs-service-integrations to obs-infraobs-integrations | 8.2.0 |
| **0.3.1** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/5123))Added categories and/or subcategories. | 8.2.0 |
| **0.3.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/5041))Update ECS version to 8.5.1 | 8.2.0 |
| **0.2.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/4485))Added infrastructure category. | 8.2.0 |
| **0.1.0** | **Enhancement** ([View pull request](https://github.com/elastic/integrations/pull/1234))Initial integration package creation of Memcached | 8.2.0 |