dockercisco/telemetryreceiver

镜像概述

dockercisco/telemetryreceiver是一款用于接收Cisco交换机遥测数据的Docker镜像，支持将数据转发至Splunk或Elasticsearch，便于用户监控网络设备的接口统计等信息，适用于企业级网络管理场景。

核心功能

1. 接收Cisco Nexus 3000/9000系列交换机的遥测数据（如接口计数器、物理接口信息）
2. 支持gRPC协议与GPB编码，提供TLS安全传输配置
3. 将数据转发至Elasticsearch，结合ELK栈实现可视化分析
4. 灵活配置订阅间隔与监控范围，满足定制化需求

使用场景

• 企业网络设备状态实时监控
• 网络性能数据分析与故障排查
• 网络流量趋势可视化展示

配置说明

一、Cisco Nexus设备配置示例

以下配置监控Ethernet2/1接口计数器，并发送至遥测接收器（地址：172.31.219.148:50001）：

telemetry
  destination-group 1
    ip address 172.31.219.148 port 50001 protocol gRPC encoding GPB 
  sensor-group 1
    path sys/intf/phys-[eth2/1]/dbgIfIn depth 0 
  sensor-group 2
    path sys/intf/phys-[eth2/1]/phys depth 0 
  subscription 1
    dst-grp 1
    snsr-grp 1 sample-interval 5000
  subscription 2
    dst-grp 1
    snsr-grp 1 sample-interval 0

1.1 全接口统计推送（每30秒gRPC传输）

telemetry
  destination-group 1
    ip address 172.31.219.148 port 50001 protocol gRPC encoding GPB 
  sensor-group 1
    path sys/intf depth unbounded
  subscription 1
    dst-grp 1
    snsr-grp 1 sample-interval 30000

1.2 TLS安全传输配置

telemetry
  certificate /bootflash/server.crt localhost
  destination-group 1
    ip address 172.31.219.148 port 50001 protocol gRPC encoding GPB 
  sensor-group 1
    path sys/intf depth unbounded
  subscription 1
    dst-grp 1
    snsr-grp 1 sample-interval 30000

二、遥测接收器部署

2.1 拉取镜像

bash
docker pull dockercisco/telemetryreceiver:latest

2.2 运行容器

bash
docker run -it -p <主机端口>:<容器端口> <镜像ID> bash

示例：

bash
sudo docker run -p 50001:50001 -it c7b476917147 bash

2.3 启动接收器

进入目录：

bash
cd /grpc/telemetry/src

创建Elasticsearch索引映射：

bash
curl -XPUT 'localhost:9200/telemetry/' -d '{
    "settings" : {
        "index.mapping.total_fields.limit" : 1000000000,
        "number_of_shards" : 1,
        "number_of_replicas" : 1
    }
}'
 
curl -XPUT 'localhost:9200/telemetry/d852e3c1/_mapping' -d'
{
    "d852e3c1" : {
        "properties" : {
            "postDate" : {"type" : "date",  "format": "yyyy-MM-dd HH:mm:ss z||yyyy-MM-dd||epoch_millis||yyyy-MM-dd HH:mm:ss.SSS z" },
        }
    }
}'

启动非安全接收器：

bash
./telemetry_receiver <监听端口> <目标IP> <目标端口> 1 

启动安全接收器：

bash
./telemetry_receiver <监听端口> <目标IP> <目标端口> 1 2 <私钥> <公证书>

示例：

bash
./telemetry_receiver 50001 172.31.219.148 9200 1 
Enter Elasticsearch index[telemetry]: 
Enter Elasticsearch type[d852e3c1]: 
Index: telemetry type:d852e3c1
Server listening on 0.0.0.0:50003

三、ELK栈部署

3.1 拉取ELK镜像

bash
docker pull dockercisco/elklat 

3.2 运行ELK容器

bash
docker run -p 5601:5601 -p 9200:9200 -it <镜像ID> bash       

3.3 启动服务

bash
service elasticsearch start                                                                               
service kibana start             

四、Kibana使用

1. 访问：http://localhost:5601
2. 配置索引模式：设置→索引→输入telemetry
3. 选择时间字段postDate创建索引
4. 发现页面查看数据，可视化页面构建图表

五、故障排除

• 查看ELK索引：curl 'localhost:9200/_cat/indices?v'
• 检查遥测数据：curl -XGET 'localhost:9200/telemetry/_search?size=10000&pretty'
• 调整ELK参数：sysctl -w vm.max_map_count=262144

参考资料

• Cisco Nexus 9000配置指南
• Kibana官方文档