夜莺-Nightingale
          
            
                
                
                
                
            
          
            
                
                
                夜莺V6
                  
                      
                        
  
  
    
      项目介绍
    
  
                      
                        
  
  
    
      架构介绍
    
  
                      
                        
  
                
    
      快速开始
    
    
  
  
                      
                        
  
  
    
      黄埔营
    
  
                      
                        
  
    
      安装部署
    
    
  
  
                      
                        
  
  
    
      升级
    
  
                      
                        
  
    
      采集器
    
    
  
  
                      
                        
  
    
      使用手册
    
    
  
  
                      
                        
  
    
      API
    
    
  
  
                      
                        
  
    
      数据库表结构
    
    
  
  
    
      
  
  
    
      alert_aggr_view
    
  
    
      
  
  
    
      alert_cur_event
    
  
    
      
  
  
    
      alert_his_event
    
  
    
      
  
  
    
      alert_mute
    
  
    
      
  
  
    
      alert_rule
    
  
    
      
  
  
    
      alert_subscribe
    
  
    
      
  
  
    
      alerting_engines
    
  
    
      
  
  
    
      board
    
  
    
      
  
  
    
      board_payload
    
  
    
      
  
  
    
      builtin_cate
    
  
    
      
  
  
    
      busi_group
    
  
    
      
  
  
    
      busi_group_member
    
  
    
      
  
  
    
      chart_share
    
  
    
      
  
  
    
      configs
    
  
    
      
  
  
    
      datasource
    
  
    
      
  
  
    
      metric_view
    
  
    
      
  
  
    
      notify_tpl
    
  
    
      
  
  
    
      recording_rule
    
  
    
      
  
  
    
      role
    
  
    
      
  
  
    
      role_operation
    
  
    
      
  
  
    
      sso_config
    
  
    
      
  
  
    
      target
    
  
    
      
  
  
    
      task_record
    
  
    
      
  
  
    
      task_tpl
    
  
    
      
  
  
    
      task_tpl_host
    
  
    
      
  
  
    
      user_group
    
  
    
      
  
  
    
      user_group_member
    
  
    
      
  
  
    
      users
    
  
    
  
                      
                        
  
    
      FAQ
    
    
  
  
    
      
  
  
    
      转发数据给多个时序库
    
  
    
      
  
  
    
      机器列表数据异常
    
  
    
      
  
  
    
      数据流图
    
  
    
      
  
  
    
      监控数据时有时无
    
  
    
      
  
  
    
      查询原始监控数据
    
  
    
      
  
  
    
      快捷视图详解
    
  
    
      
  
  
    
      告警自愈模块使用
    
  
    
      
  
  
    
      仪表盘里只展示我的机器
    
  
    
      
  
  
    
      仪表盘里图表数据缺失
    
  
    
      
  
  
    
      设置自定义告警通知方式
    
  
    
      
  
  
    
      target_up指标的问题
    
  
    
      
  
  
    
      夜莺可以监控 x 么
    
  
    
      
  
  
    
      告警和恢复的判断逻辑
    
  
    
      
  
  
    
      容量规划问题
    
  
    
      
  
  
    
      connection refused
    
  
    
      
  
  
    
      登录与认证
    
  
    
      
  
  
    
      数据采集器Categraf
    
  
    
      
  
  
    
      日志写到`/var/log/messages`
    
  
    
      
  
  
    
      告警规则&告警模板如何引用变量
    
  
    
      
  
  
    
      采集到的数据是字符串怎么处理
    
  
    
      
  
  
    
      管理员密码忘记了
    
  
    
      
  
  
    
      制作大盘如何添加图片
    
  
    
      
  
  
    
      添加loki数据源报错
    
  
    
      
  
  
    
      v6小版本升级有什么 sql 要执行吗
    
  
    
      
  
  
    
      机器列表有展示,但采集数据查询不到
    
  
    
      
  
  
    
      n9e 启动异常报错
    
  
    
      
  
  
    
      n9e集群部署配置修改
    
  
    
      
  
  
    
      告警触发/恢复的值怎么获取
    
  
    
      
  
  
    
      推送 Promethus 报错 OOO
    
  
    
      
  
  
    
      机器列表怎么忽略云资源
    
  
    
      
  
  
    
      告警规则仅在本业务组生效失败
    
  
    
      
  
  
    
      categraf 启动 oracle 插件报错
    
  
    
      
  
  
    
      告警自愈不生效
    
  
    
      
  
  
    
      n9e查询时序库EOF报错
    
  
    
      
  
  
    
      手动编译项目报错
    
  
    
      
  
  
    
      promQL 使用函数标签信息丢失
    
  
    
      
  
  
    
      内存使用率+可用率不等于100
    
  
    
      
  
  
    
      夜莺仪表盘有哪些内置变量
    
  
    
      
  
  
    
      categraf配置文件支持热加载吗
    
  
    
      
  
  
    
      导入 Grafana 仪表盘无效数据源
    
  
    
      
  
  
    
      如何查看报错消息
    
  
    
  
                      
                  采集器-Categraf
          
          
          
          
        
          
          
          
        
          
          
          
        
          
          
          
        
          
          
          
        
          
          
          
        
          
          
          
        
          
          
          
        
        开源生态
          
            
            Telegraf
              
            Prometheus
              
                  
                    
  
  
    
      版权声明
    
  
                  
                    
  
            
    
      第1章:天降奇兵
    
    
  
  
                  
                    
  
    
      第2章:探索PromQL
    
    
  
  
    
      
  
  
    
      开篇
    
  
    
      
  
  
    
      理解时间序列
    
  
    
      
  
  
    
      Metrics类型
    
  
    
      
  
  
    
      初识PromQL
    
  
    
      
  
  
    
      PromQL操作符
    
  
    
      
  
  
    
      PromQL聚合操作
    
  
    
      
  
  
    
      PromQL内置函数
    
  
    
      
  
  
    
      在HTTP API中使用PromQL
    
  
    
      
  
  
    
      最佳实践:4个黄金指标和USE方法
    
  
    
      
  
  
    
      小结
    
  
    
  
                  
                    
  
    
      第3章:Prometheus告警处理
    
    
  
  
    
      
  
  
    
      开篇
    
  
    
      
  
  
    
      Prometheus告警简介
    
  
    
      
  
  
    
      自定义Prometheus告警规则
    
  
    
      
  
  
    
      部署Alertmanager
    
  
    
      
  
  
    
      Alertmanager配置概述
    
  
    
      
  
  
    
      基于标签的告警处理路由
    
  
    
      
  
                  
                    
  
    
      使用Receiver接收告警信息
    
    
  
  
    
      
  
  
    
      告警模板详解
    
  
    
      
  
  
    
      屏蔽告警通知
    
  
    
      
  
  
    
      使用Recoding Rules优化性能
    
  
    
      
  
  
    
      小结
    
  
    
  
    
      第4章:Exporter详解
    
    
  
  
                  
                    
  
    
      第5章:数据与可视化
    
    
  
  
                  
                    
  
    
      第6章:集群与高可用
    
    
  
  
                  
                    
  
    
      第7章:Prometheus服务发现
    
    
  
  
                  
                    
  
    
      第8章:监控Kubernetes
    
    
  
  
    
      
  
  
    
      开篇
    
  
    
      
  
  
    
      初识Kubernetes
    
  
    
      
  
  
    
      在Kubernetes下部署Prometheus
    
  
    
      
  
  
    
      Kubernetes下的服务发现
    
  
    
      
  
  
    
      使用Prometheus监控Kubernetes集群
    
  
    
      
  
  
    
      基于Prometheus的弹性伸缩
    
  
    
      
  
  
    
      小结
    
  
    
  
                  
                    
  
    
      第9章:Prometheus Operator
    
    
  
  
                  
                    
  
  
    
      参考资料
    
  
                  
              編寫網絡設備采集模板
在采集模板中點擊右上角“新增”即可新增自定義采集模板。

下面是 SNMP 設備的自定義采集配置示例和基本參數說明。

基礎參數說明
community:從設備配置文件或管理界面獲取的參數,通常設置為 “public”。

agent_host_tag:用於標識設備 IP 的標籤名稱。

retries:SNMP 請求失敗時系統重試的次數。
max_repetitions:SNMP 一次請求中最多請求對象的數量。注意:此值越高,可能會減少請求次數,但也可能增加網絡負載。
獲取 Scalar 數據類型:這些數據點在 MIB 中由單個 OID 標識。
# 獲取 Scalar 數據
# CPU 系統態使用率
[[instances.field]]
oid = "1.3.6.1.4.1.2021.11.9.0"
name = "cpu_usage_sys"
# CPU 用戶態使用率
[[instances.field]]
oid = "1.3.6.1.4.1.2021.11.10.0"
name = "cpu_usage_user"
# 設備空閒記憶體
[[instances.field]]
oid = "1.3.6.1.4.1.2021.4.6.0"
name = "mem_free"
獲取 Table 類數據:包括多列數據和多個索引。Categraf 將自動檢索 Table 中的所有索引字段作為時序數據的標籤,並自動獲取所有數據列作為指標上報。
# 獲取 Table 類數據
[[instances.table]]
oid = "IF-MIB::ifTable"
name = "interface"
[[instances.table.field]]
oid = "IF-MIB::ifDescr"
name = "ifDescr"
# 有些列可能不是數值,比如 ifDescr 就是字符串,這個列無需作為指標上報,應該作為標籤上報更合適,所以有個 is_tag=true 的配置。
is_tag = true
OID:用於唯一標識網絡管理協議(如 SNMP)中每個管理對象的標識符。它是一種標準化的編號系統,用於識別管理信息庫(MIB)中的對象及其層次結構。
- 樹狀結構:OID 表示分層的命名系統,每個節點都是一個數字,代表樹的一個層次。
 - 從根節點開始:所有 OID 都從根節點(0)開始,然後逐級向下。
 
例如,OID 1.3.6.1.2.1.1.3.0 可分解為:
- 1:ISO 標識符
 - 3:組織編號
 - 6:企業編號
 - 1:管理編號
 - 2:標準編號
 - 1:MIB-II
 - 1:系統組
 - 3:系統運行時間
 - 0:具體實例
 
保存模板後,可以在即時查詢中查看指標。

排錯分析:
如果配置完成後未能查看到相關指標,可以在網絡設備上執行以下相關命令確認是否有返回值。
正常網絡設備返回值:

網絡設備無返回值:

排錯方向:
- OID 路徑是否正確,不同設備和廠商可能會有不同的 OID 來表示相同的對象;
 - SNMP 是否正確加載了相關的 MIB 模塊;
 - 網絡設備是否使用私有 OID,這些 OID 可能需要配置特定的 MIB 模塊或特定的硬件或軟件支持;
 - 檢查 SNMPD 配置文件中的字符串(public)權限和優先級順序問題。