Nightingale 接入 Meraki 网络设备从 0 到 1 的完整采集配置【免费下载链接】nightingaleNightingale is to monitoring and alerting what Grafana is to visualization.项目地址: https://gitcode.com/GitHub_Trending/ni/nightingale你手里的设备早已托管在 Meraki 云平台可告警大屏上只见服务器 CPU 和磁盘链路状态却毫无抓手怎么把这些网络设备指标拉进监控系统本文以开源监控告警系统 Nightingale 内置的 Meraki 集成组件为例给出一份可直接落地的 Categraf 采集配置并把每个字段是干什么的、怎么填讲透。先给蓝图一份文件看全 Meraki 采集配置接入要用的全部信息都在 meraki.toml 这一个文件里。组件目录下的 README.md 与英文版只放了下面这份配置示例没有其他内容可以直接照抄interval60 [[instances]] #api_keyxxxxx #base_urlhttps://api.meraki.cn/api/v1 #network_result_per_page100000 #rate_limit5 [instances.signal_4g] urlxxx app_key app_secret app_id [instances.extra_info] urlxxxx query probe_success{clusterhedan-prod-elk,jobicmp,isOpenTrue} 先扫一眼全貌配置分三块顶层interval60全局采集周期作用于本文件所有实例[[instances]]主实例对接 Meraki API四个参数默认全部被注释[instances.signal_4g]与[instances.extra_info]两个子实例挂在主实例下的两个可选附加采集目标。这份配置被谁读取在哪里生效integrations/里的文件不是只给人看的文档服务端有两条消费链路。链路一集成中心。center/integration/init.go 的Init函数在启动时扫描integrations/下每个子目录把每个目录注册为内置组件BuiltinComponent读取icon/下的 logo对外路径形如/api/n9e/integrations/icon/组件名/文件、读取markdown/下的 README 作为组件详情页并装载alerts/、dashboards/、metrics/模板。系统配置项disable_integration_init一旦设置会跳过整个初始化。Meraki 组件比较精简只有 collect/icon/markdown 三个子目录没有告警规则与仪表盘模板属于文档采集模板型。链路二AI 文档索引。aiagent/tools/integrations_loader.go 扫描同一个目录每个组件的markdown/README.md生成一条[integration-doc]条目每个collect/*/*.toml生成一条[integration-config]条目内容用 toml 围栏包裹避免 LLM 把配置当散文改写ghBlobURL再为每条索引生成指向上游仓库对应文件的稳定链接供 Agent 溯源。文件头注释写得很直白integrations/下每个组件是 Categraf 配置语法和指标命名的权威 ground truthLLM 经search_n9e_docs检索时能直接搜到真实的[[instances]]写法。换句话说你在集成中心Components页面能看到的 Meraki 卡片和 AI 检索时命中的那份配置源头都是这一份 TOML。主实例参数为什么默认全部注释因为四行全是取消注释才生效的可选项模板不强制任何值。README 未提供字段说明下表按参数命名与 Meraki Dashboard API 的通行惯例推断实际接入时请以你控制台的字段描述为准参数是什么怎么填interval全局采集周期秒作用于本文件全部实例示例为 60网络设备监控的稳妥起点api_key主实例唯一必需的凭据Meraki Dashboard API 密钥Meraki 控制台生成后取消注释填入base_urlAPI 服务地址示例为中国区.cn端点其他区域组织换用对应端点路径保留/api/v1network_result_per_page分页请求单次返回的网络记录条数网络多保持大值减少请求次数网络少可调小rate_limitAPI 请求速率限制示例值 5用于规避限流按配额与网络规模调整太小拖慢采集太大被限流interval 该设多少秒顶层interval60是 Categraf 插件配置的通用顶层约定表示采集器每隔 60 秒执行一次本插件的抓取任务。Meraki 属于拉全量网络列表再逐层下钻的采集方式60 秒足够想调快时先确认rate_limit不会被撞穿。base_url 区域选择速查示例值https://api.meraki.cn/api/v1用的是.cn域名对应中国区端点。其他区域的组织请按控制台展示的端点填写一般惯例为 api.meraki.com以你的控制台为准注意路径含/api/v1版本段别只填域名。一个插件为什么挂两个子实例两个子实例在语法上都是instances数组末项的子表相当于给主实例按需再挂一组采集目标且两者数据源完全不同。signal_4g4G 信号数据的独立凭据组[instances.signal_4g]采集 4G 信号相关数据信号强度、连接状态一类但它不用 Meraki 的api_key而是自带url app_key app_secret app_id一组凭据——数据来自一个独立的 4G 设备/平台接口。应用 ID 密钥对是开放平台常见的鉴权形态与钉钉、飞书等开放平台应用凭据组合形态一致本仓库告警通知模块对接飞书时使用的就是app_id/app_secret这类应用凭据。模板里url是占位符xxx、其余三项为空串需填真实接口地址与凭据才能工作。extra_info用另一个数据源补充设备指标[instances.extra_info]用url指向另一个查询接口用 PromQLquery拉取附加信息与主实例采到的设备原始数据互补。示例查询probe_success{clusterhedan-prod-elk,jobicmp,isOpenTrue}probe_success是黑盒探针blackbox_exporter的标准指标示例按标签过滤出某集群的 ICMP 探测结果。⚠️ 查询里的标签值是模板编写者环境的具体数据必须替换成你自己环境的标签才能把探活结果与 Meraki 设备的链路状态关联起来。两个子实例什么时候能省都是按需模块。你的场景不涉及 4G 信号、也不需要关联探活数据时删掉这两块子实例、只保留顶层interval与主实例即可这就是最小可用配置留着占位值不改动则两个数据源相当于未启用。落地清单核对、填写、验证分三组勾完一次接通。核对前提Categraf 采集端已装好并在运行能确定插件采集配置目录的位置已把 meraki.toml 复制进该目录或以它为模板新建插件配置想要最新模板的话可克隆仓库获取git clone https://gitcode.com/GitHub_Trending/ni/nightingale文件位于integrations/Meraki/下填写凭据与参数取消api_key注释填入 Meraki Dashboard API 密钥核对base_url区域示例为中国区.cn端点海外组织换成对应端点按网络数量调整network_result_per_page与rate_limit需要 4G 信号采集时补全signal_4g的url与app_key/app_secret/app_id三件套需要探活关联时把extra_info的url与query标签替换为自身环境✅ 验证数据重启 Categraf 使配置生效Nightingale 指标查询页能检索到 Meraki 插件上报的指标集成中心Components页面出现 Meraki 组件卡片且 README 正常展示看懂这一份就懂了大部分集成顶层 interval 主实例 按需子实例是 integrations 目录下上百个集成组件的通用范式顶层管节奏主实例接核心数据源子实例按需挂载。换个监控对象只需替换数据源与凭据骨架不变Cloudflare、Redis 等兄弟组件的采集模板都可以按同样方式直接上手。【免费下载链接】nightingaleNightingale is to monitoring and alerting what Grafana is to visualization.项目地址: https://gitcode.com/GitHub_Trending/ni/nightingale创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考