yehudayefet/memcached-stats

镜像概述

本Docker镜像旨在帮助用户将Memcached的统计数据推送至Elasticsearch，以便在Kibana等工具中进行可视化分析（如绘制图表、构建实时监控仪表盘）。

核心功能

• 收集Memcached实例的关键统计数据（如连接数、缓存命中/未命中数、字节读写量等）
• 将统计数据推送至Elasticsearch，支持后续的数据分析与可视化
• 通过环境变量灵活配置Memcached和Elasticsearch的连接信息

使用场景

• 实时监控Memcached服务的运行状态
• 分析缓存性能（如命中率、内存使用情况）
• 构建Memcached的历史性能趋势报表

配置说明

镜像启动时需设置以下环境变量：

• MEMCACHED_HOST：Memcached实例的主机地址
• MEMCACHED_PORT：Memcached实例的端口（默认***）
• ES_HOST：Elasticsearch实例的主机地址
• ES_PORT：Elasticsearch实例的端口（默认9200）

部署示例（Kubernetes CronJob）

建议以CronJob形式每分钟执行一次，获取实时统计数据：

yaml
apiVersion: batch/v1beta1
kind: CronJob
metadata:
  name: memcached-stats
spec:
  schedule: "*/1 * * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: memcached-stats
            image: yehudayefet/memcached-stats
            env:
             - name: MEMCACHED_HOST
               value: "name-of-memcached-service.default.svc.cluster.local"
             - name: MEMCACHED_PORT
               value: "11211"
             - name: ES_HOST
               value: "name-of-elasticsearch-logging-service.kube-system.svc.cluster.local"
             - name: ES_PORT
               value: "9200"
          restartPolicy: OnFailure

Elasticsearch映射设置

在运行容器前，需为Elasticsearch的memcached索引设置字段类型（尤其是时间字段）：

bash
curl -X DELETE "http://[your_elasticsearch_ip]:9200/memcached" && \
JSON_DATA="{\"mappings\": {\"stats\": {\"properties\": {\"time\": {\"type\": \"date\",\"format\": \"epoch_second\"},\"accepting_conns\": {\"type\": \"long\"},\"auth_cmds\": {\"type\": \"long\"},\"auth_errors\": {\"type\": \"long\"},\"bytes\": {\"type\": \"long\"},\"bytes_read\": {\"type\": \"long\"},\"bytes_written\": {\"type\": \"long\"},\"cas_hits\": {\"type\": \"long\"},\"cas_misses\": {\"type\": \"long\"},\"cmd_flush\": {\"type\": \"long\"},\"cmd_get\": {\"type\": \"long\"},\"cmd_set\": {\"type\": \"long\"},\"cmd_touch\": {\"type\": \"long\"},\"conn_yields\": {\"type\": \"long\"},\"connection_structures\": {\"type\": \"long\"},\"crawler_items_checked\": {\"type\": \"long\"},\"crawler_reclaimed\": {\"type\": \"long\"},\"curr_connections\": {\"type\": \"long\"},\"curr_items\": {\"type\": \"long\"},\"decr_hits\": {\"type\": \"long\"},\"decr_misses\": {\"type\": \"long\"},\"delete_hits\": {\"type\": \"long\"},\"delete_misses\": {\"type\": \"long\"},\"evicted_unfetched\": {\"type\": \"long\"},\"evictions\": {\"type\": \"long\"},\"expired_unfetched\": {\"type\": \"long\"},\"get_expired\": {\"type\": \"long\"},\"get_flushed\": {\"type\": \"long\"},\"get_hits\": {\"type\": \"long\"},\"get_misses\": {\"type\": \"long\"},\"hash_bytes\": {\"type\": \"long\"},\"hash_is_expanding\": {\"type\": \"long\"},\"hash_power_level\": {\"type\": \"long\"},\"incr_hits\": {\"type\": \"long\"},\"incr_misses\": {\"type\": \"long\"},\"limit_maxbytes\": {\"type\": \"long\"},\"listen_disabled_num\": {\"type\": \"long\"},\"log_watcher_sent\": {\"type\": \"long\"},\"log_watcher_skipped\": {\"type\": \"long\"},\"log_worker_dropped\": {\"type\": \"long\"},\"log_worker_written\": {\"type\": \"long\"},\"lrutail_reflocked\": {\"type\": \"long\"},\"malloc_fails\": {\"type\": \"long\"},\"pid\": {\"type\": \"long\"},\"pointer_size\": {\"type\": \"long\"},\"reclaimed\": {\"type\": \"long\"},\"reserved_fds\": {\"type\": \"long\"},\"rusage_system\": {\"type\": \"float\"},\"rusage_user\": {\"type\": \"float\"},\"threads\": {\"type\": \"long\"},\"time_in_listen_disabled_us\": {\"type\": \"long\"},\"total_connections\": {\"type\": \"long\"},\"total_items\": {\"type\": \"long\"},\"touch_hits\": {\"type\": \"long\"},\"touch_misses\": {\"type\": \"long\"},\"uptime\": {\"type\": \"long\"}}}}}"  && \
curl -X PUT -H "Content-Type: application/json" -H "Cache-Control: no-cache" -d "$JSON_DATA" "http://[your_elasticsearch_ip]:9200/memcached"

注：示例中Memcached端口默认值已修正为***（原示例误写为Redis端口6379），使用时请根据实际环境调整。