Merge pull request #377 from kongfei605/aliyun

pre-release

inputs/exec/scripts/cert/collect_cert_expiretime.sh

@@ -6,10 +6,10 @@
 input_name=cert
 
 # 自定义标签
-cloud="huaweicloud"
-region="huabei-beijing-4"
+cloud="my-cloud"
+region="my-region"
 azone="az1"
-product="cert"
+product="my-product"
 
 # 需要被检测证书过期的域名
 domain_list=(
@@ -23,16 +23,17 @@ function check_ssl() {
   ts=$(date +%s)
   #localip=$(/usr/sbin/ifconfig `/usr/sbin/route | grep '^default' | awk '{print $NF}'` | grep inet | awk '{print $2}' | head -n 1)
 
-  ping -c1 223.5.5.5 &> /dev/null
+  ping -c1 ${domain} &> /dev/null
   if [ $? -eq 0 ];then
     END_TIME=$(echo | timeout 3 openssl s_client -servername ${domain} -connect "${domain}:443" 2>/dev/null | openssl x509 -noout -enddate 2>/dev/null | awk -F '=' '{print $2}' )
     END_TIME_STAMP=$(date +%s -d "${END_TIME}")
     NOW_TIME__STAMP=$(date +%s)
     ssl_expire_days=$(($((${END_TIME_STAMP} - ${NOW_TIME__STAMP}))/(60*60*24)))
-    metrics="${input_name},cloud=${cloud},region=${region},azone=${azone},product=${product},domain_name=${domain} expire_days=${ssl_expire_days}"
+    metrics="${input_name},cloud=${cloud},region=${region},azone=${azone},product=${product},domain_name=${domain} expire_days=${ssl_expire_days},reachable=1"
     echo $metrics
   else
-    pass
+    metrics="${input_name},cloud=${cloud},region=${region},azone=${azone},product=${product},domain_name=${domain} expire_days=${ssl_expire_days},reachable=0"
+    echo $metrics
   fi
 }
 

inputs/nginx/README.md

@@ -1,9 +1,12 @@
+- 该插件依赖**nginx**的 **http_stub_status_module
+
 # 应用场景
 一般用于业务系统做对外或对外路由映射时使用代理服务，是运维最常见且最重要的代理工具。
 
 # 部署场景
 需要在装有nginx服务的虚拟机启用此插件。
 
+
 # 前置条件
 ```
 条件1：nginx服务需要启用http_stub_status_module模块
@@ -128,7 +131,7 @@ urls = [
 ]
 
 ## append some labels for series
-labels = { cloud="huaweicloud", region="huabei-beijing-4",azone="az1", product="nginx" }
+labels = { cloud="my-cloud", region="my-region",azone="az1", product="my-product" }
 
 ## interval = global.interval * interval_times
 # interval_times = 1
@@ -185,7 +188,10 @@ journalctl -f -n 500 -u categraf | grep "E\!" | grep "W\!"
 
 # 监控告警规则配置
 ```
-先略过
+```
+个人经验仅供参考：
+超过2000毫秒，为P2级别，启用企业微信应用推送告警，3分钟内恢复发出恢复告警。
+超过5000毫秒，为P1级别，启用电话语音告警&企业微信应用告警，3分钟内恢复发出恢复告警。
 ```
 
 # 监控图表配置

inputs/nginx_upstream_check/README.md

@@ -4,6 +4,13 @@
 # 部署场景
 需要在装有nginx服务的虚拟机启用此插件。
 
+# 采集原理
+
+- 该采集插件是读取 [nginx_upstream_check](https://github.com/yaoweibin/nginx_upstream_check_module) 的状态输出。[nginx_upstream_check](https://github.com/yaoweibin/nginx_upstream_check_module) 可以周期性检查 upstream 中的各个 server 是否存活，如果检查失败，就会标记为 `down`，如果检查成功，就标记为 `up`。
+
+# 注意事项
+- 由于 TSDB 通常无法处理字符串，所以 Categraf 会做转换，将 `down` 转换为 2， `up` 转换为 1，其他状态转换为 0，使用 `nginx_upstream_check_status_code` 这个指标来表示，所以，我们可能需要这样的告警规则：
+
 # 前置条件
 ## 条件1：nginx服务需要启用nginx_upstream_check_module模块
 ```
@@ -142,12 +149,19 @@ urls字段填写条件2所定义好的域名。
 # interval = 15
 
 [[instances]]
+# 这个配置最关键，是要给出获取 status 信息的接口地址
 targets = [
     "https://nginx-upstream.domains.com/?format=json"
 ]
 
+# 标签这个配置请注意
+# 如果 Categraf 和 Nginx 是在一台机器上，target 可能配置的是 127.0.0.1
+# 如果 Nginx 有多台机器，每台机器都有 Categraf 来采集本机的 Nginx 的 Status 信息
+# 可能会导致时序数据标签相同，不易区分，当然，Categraf 会自带 ident 标签，该标签标识本机机器名
+# 如果大家觉得 ident 标签不够用，可以用下面 labels 配置，附加 instance、region 之类的标签
+
 # # append some labels for series
-labels = { cloud="huaweicloud", region="huabei-beijing-4",azone="az1", product="nginx-upstream" }
+labels = { cloud="my-cloud", region="my-region",azone="az1", product="my-product" }
 
 # # interval = global.interval * interval_times
 # interval_times = 1