New

The executive guide to generative AI

Read more

Memcahed integration

edit

Memcahed integration

edit

Version

1.6.0 (View all)

Compatible Kibana version(s)

8.13.0 or higher

Supported Serverless project types
What’s this?

Security
Observability

Subscription level
What’s this?

Basic

Level of support
What’s this?

Elastic

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

edit

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

edit

The below metrics are fetched from memcached:

ECS Field Reference

Please refer to the following document for detailed information on ECS fields.

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

Example

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.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"
    ]
}

Changelog

edit
Changelog
Version Details Kibana version(s)

1.6.0

Enhancement (View pull request)
Add processor support for stats data stream.

8.13.0 or higher

1.5.0

Enhancement (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

Enhancement (View pull request)
Add global filter on data_stream.dataset to improve performance.

8.8.0 or higher

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

Was this helpful?
Feedback