添加或修改应用发现规则

功能介绍

该接口用于添加或修改一条或多条应用发现规则。同一projectid下可添加的规则上限为100条。

URI

PUT /v1/{project_id}/inv/servicediscoveryrules

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	租户从IAM申请到的projectid,一般为32位字符串。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	从IAM服务获取的用户Token。
Content-Type	是	String	指定类型为application/json。

表3 请求Body参数
参数	是否必选	参数类型	描述
appRules	否	Array of AppRules objects	服务参数。

表4 AppRules
参数	是否必选	参数类型	描述
createTime	否	String	规则创建时间(创建时不传,修改时传查询返回的createTime)。
enable	是	Boolean	true、false 规则是否启用。
eventName	是	String	aom_inventory_rules_event 规则事件名称,对于服务发现固定为"aom_inventory_rules_event"。枚举值： aom_inventory_rules_event
hostid	否	Array of strings	主机ID(暂不使用,传空即可)。
id	是	String	创建时填空，修改时填规则ID。
name	是	String	规则名称。字符长度小于64位,以小写字母(a-z)开头,只能包含0-9/a-z/-,不能以-结尾。
projectid	是	String	租户从IAM申请到的projectid,一般为32位字符串。
spec	是	AppRulesSpec object	规则详情。

表5 AppRulesSpec
参数	是否必选	参数类型	描述
appType	否	String	服务类型,用于标记服务的分类,仅用于规则分类和界面展示。可以填写任意字段,如按技术栈分类可填写Java,Python。按作用分类可填写collector(采集),database(数据库)等。
attrList	否	Array of strings	属性列表(暂不使用,可不传)。 cmdLine、env
detectLog	否	String	是否开启日志采集。 true、false
discoveryRule	是	Array of DiscoveryRule objects	规则发现部分,数组中有多个对象时表示需要同时满足所有条件的进程才会被匹配到。 checkType为cmdLine时checkMode填contain,checkContent格式为[“xxx”]表示进程命令行参数中需要包含xxx。checkType为env时checkMode填contain,checkContent格式为 ["k1","v1"]表示进程环境变量中需要包含名为k1值为v1的环境变量。checkType为scope时checkMode填equals,checkContent格式为节点ID数组["hostId1”,”hostId2”],表示规则仅会在这些节点上生效(如果不指定节点范围,规则将下发到该项目所有的节点)。
isDefaultRule	是	String	是否为默认规则。 true、false
isDetect	是	String	是否为规则预探测场景(预探测场景不会保存规则,仅用于规则下发之前验证该规则能否有效发现节点上的进程)。 true、false
logFileFix	否	Array of strings	日志文件的后缀。 log、trace、out
logPathRule	否	Array of LogPathRule objects	日志路径配置规则。当cmdLineHash为固定字符串时,指定日志路径或者日志文件。否则只采集进程当前打开的以.log和.trace结尾的文件。nameType取值cmdLineHash时,args格式为["00001"],value格式为["/xxx/xx.log"],表示当启动命令是00001时,日志路径为/xxx/xx.log。
nameRule	是	NameRule object	发现上来的服务、应用的命名规则。
priority	是	String	规则优先级。 1~9999的整数字符串,默认取值为9999

表6 DiscoveryRule
参数	是否必选	参数类型	描述
checkContent	是	Array of strings	匹配值。
checkMode	是	String	匹配条件。 contain、equals
checkType	是	String	匹配类型。 cmdLine、env、scope

表7 LogPathRule
参数	是否必选	参数类型	描述
args	否	Array of strings	命令行。
nameType	否	String	取值类型。 cmdLineHash
value	否	Array of strings	日志路径。

表8 NameRule
参数	是否必选	参数类型	描述
appNameRule	是	Array of AppNameRule objects	服务命名部分,数组中有多个对象时表示将每个对象抽取到的字符串拼接作为服务的名称。 nameType取值cmdLine时args格式为["start","end"],表示抽取命令行中start、end之间的字符。 nameType取值cmdLine时args格式为["aa"],表示抽取环境变量名为aa对应的环境变量值。 nameType取值str时,args格式为["fix"],表示服务名称最后拼接固定文字fix。 nameType取值cmdLineHash时,args格式为["0001"],value格式为["ser"],表示当启动命令是0001时,服务名称为ser。
applicationNameRule	是	Array of ApplicationNameRule objects	应用命名部分。 nameType取值cmdLine时args格式为["start","end"],表示抽取命令行中start、end之间的字符。 nameType取值cmdLine时args格式为 ["aa"],表示抽取环境变量名为aa对应的环境变量值。 nameType取值str时,args格式为["fix"],表示服务名称最后拼接固定文字fix。 nameType取值cmdLineHash时,args格式为["0001"],value格式为["ser"],表示当启动命令是0001时,应用名称为ser。

表9 AppNameRule
参数	是否必选	参数类型	描述
nameType	是	String	取值类型。从cmdLineHash、cmdLine、env、str里面选取。
args	是	Array of strings	输入值。
value	否	Array of strings	服务名(仅nameType为cmdLineHash时填写)。

**表10** ApplicationNameRule
参数	是否必选	参数类型	描述
nameType	是	String	取值类型。从cmdLineHash、cmdLine、env、str里面选取。
args	是	Array of strings	输入值。
value	否	Array of strings	服务名(仅nameType为cmdLineHash时填写)。

响应参数

状态码： 200

**表11** 响应Body参数
参数	参数类型	描述
errorCode	String	响应码。
errorMessage	String	响应信息描述。
responseStatus	Integer	响应状态码。

请求示例

添加或修改一条或多条应用发现规则

PUT https://{Endpoint}/v1/{project_id}/inv/servicediscoveryrules

{
  "appRules" : [ {
    "id" : "44d6c4bb-f673-4bf4-8d33-313832f37b28",
    "name" : "bytest",
    "createTime" : "",
    "projectid" : "5a6036f48e954fcd84d198cb28db311a",
    "enable" : true,
    "hostid" : [ ],
    "eventName" : "aom_inventory_rules_event",
    "spec" : {
      "detectLog" : "true",
      "logFileFix" : [ "log", "trace" ],
      "discoveryRule" : [ {
        "checkType" : "cmdLine",
        "checkMode" : "contain",
        "checkContent" : [ "default" ]
      }, {
        "checkType" : "scope",
        "checkMode" : "equals",
        "checkContent" : [ "44d6c4bb-f673-4bf4-8d33-313832f37b28" ]
      } ],
      "attrList" : [ "cmdLine" ],
      "isDetect" : "false",
      "priority" : "1",
      "nameRule" : {
        "appNameRule" : [ {
          "nameType" : "cmdLineHash",
          "args" : [ "00000000001" ],
          "value" : [ "serviceName1" ]
        }, {
          "nameType" : "cmdLine",
          "args" : [ "/var/paas/kubernetes/", "/kubeconfig" ]
        }, {
          "nameType" : "env",
          "args" : [ "APP_NAME" ]
        }, {
          "nameType" : "str",
          "args" : [ "kube" ]
        } ],
        "applicationNameRule" : [ {
          "nameType" : "cmdLineHash",
          "args" : [ "00000000001" ],
          "value" : [ "applicationName1" ]
        }, {
          "nameType" : "str",
          "args" : [ "kubeproxy" ]
        } ]
      },
      "appType" : "",
      "isDefaultRule" : "false",
      "logPathRule" : [ {
        "nameType" : "cmdLineHash",
        "args" : [ "00000000001" ],
        "value" : [ "/xx/xxx/xx.log", "/xx/xxx/xx" ]
      } ]
    }
  } ]
}

响应示例

状态码： 200

OK 请求响应成功。

{
  "errorCode" : "SVCSTG.INV.2000000",
  "errorMessage" : "success",
  "id" : [ "44d6c4bb-f673-4bf4-8d33-313832f37b28" ]
}

状态码

状态码	描述
200	OK 请求响应成功。
400	BadRequest 非法请求。建议直接修改该请求,不要重试该请求。
401	Unauthorized 在客户端提供认证信息后,返回该状态码,表明服务端指出客户端所提供的认证信息不正确或非法。
403	Forbidden 请求被拒绝访问。返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。
500	InternalServerError 表明服务端能被请求访问到,但是不能理解用户的请求。
503	ServiceUnavailable 被请求的服务无效。建议直接修改该请求,不要重试该请求。

错误码

请参见错误码。

父主题： 监控（v1）

上一篇：删除阈值规则

下一篇：删除应用发现规则

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消