You are viewing docs on Elastic's new documentation system, currently in technical preview. For all other Elastic docs, visit elastic.co/guide.

Memcached

Memcached Integration

Version
1.3.0 (View all)
Compatible Kibana version(s)
8.8.0 or higher
Subscription level
Basic

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 below metrics are fetched from memcached:

Exported fields

FieldDescriptionTypeUnitMetric 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
ecs.version
ECS version this event conforms to. ecs.version is a required field and must exist in all events. When querying across multiple indices -- which may conform to slightly different ECS versions -- this field lets integrations adjust to the schema version of the events.
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, or a name specified by the user. The sender decides which value to use.
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
service.type
The type of the service data is collected from. The type can be used to group and correlate logs and metrics from one service type. Example: If logs or metrics are collected from Elasticsearch, service.type would be elasticsearch.
keyword
tags
List of keywords used to tag each event.
keyword

An example event for stats looks as following:

{
    "@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.5.1"
    },
    "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:c0:a8:70: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"
    ]
}

Changelog

VersionDetailsKibana version(s)

1.3.0

Enhancement View pull request
Update the package format_version to 3.0.0.

8.8.0 or higher

1.2.0

Enhancement 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

Enhancement View pull request
Add dimensions mapping for TSDB enablement.

8.8.0 or higher

1.0.0

Enhancement View pull request
Make Memcached GA

8.2.0 or higher

0.4.1

Bug fix View pull request
Updated documentation

0.4.0

Enhancement View pull request
Rename ownership from obs-service-integrations to obs-infraobs-integrations

0.3.1

Enhancement View pull request
Added categories and/or subcategories.

0.3.0

Enhancement View pull request
Update ECS version to 8.5.1

0.2.0

Enhancement View pull request
Added infrastructure category.

0.1.0

Enhancement View pull request
Initial integration package creation of Memcached

On this page