Create¶

POST /api/v1/aggs_to_metric/add

Overview¶

Create a metrics rule

Body Request Parameters¶

Parameter Name	Type	Required	Description
extend	json	Y	Additional information Can be empty: False
jsonScript	json	Y	Rule configuration Can be empty: False
jsonScript.type	string	Y	Type Example: rumToMetric Can be empty: False Can be an empty string: False Possible values: ['logToMetric', 'rumToMetric', 'apmToMetric', 'metricToMetric', 'securityToMetric', 'dialingToMetric']
jsonScript.query	json	Y	DQL query related information Can be empty: False
jsonScript.metricInfo	json	Y	Metrics configuration information Can be empty: False
jsonScript.metricInfo.every	string	Y	Frequency Example: 5m Can be an empty string: False
jsonScript.metricInfo.metric	string	Y	Measurement name Example: cpu Can be an empty string: False
jsonScript.metricInfo.metricField	string	Y	Metric name Example: load5s Can be an empty string: False
jsonScript.metricInfo.unit	string		Unit Example: load5s Can be an empty string: True
jsonScript.metricInfo.desc	string		Description Example: xxx Can be an empty string: True

Supplementary Parameter Explanation¶

Request parameter explanation.

1. **jsonScript parameter explanation

Parameter Name	type	Required	Description
type	String	Required	Data source type, enumeration type
query	Json	Required	Query information
metricInfo	Json	Required	Measurement configuration information

2. Check type jsonScript.type explanation

key	Description
rumToMetric	RUM generates Metrics
apmToMetric	APM generates Metrics
logToMetric	Logging generates Metrics
metricToMetric	Metric generates Metrics
securityToMetric	Security Check generates Metrics

3. Check type jsonScript.metricInfo explanation

Parameter Name	type	Required	Description
every	String	Required	Frequency, options are 1m, 5m, 15m, unit is (minutes/m)
metric	String	Required	Measurement name
metricField	String	Required	Metric name
unit	String		Unit
desc	String		Description

3.1 Check type jsonScript.metricInfo.unit unit explanation

Unit format: custom/["unit type","unit"] , example: custom/["time","ms"]
Custom unit format: custom/["custom","custom unit"], example: custom/["custom","tt"]
Standard unit types, refer to Unit Explanation

4. Check type jsonScript.query explanation

Parameter Name	type	Required	Description
q	String	Required	Query statement
qtype	String		Query syntax type, dql/promql
qmode	String		Query type, selector: selectorQuery , custom: customQuery, this field affects the style of front-end query echo

5. **extend parameter explanation

Parameter Name	type	Required	Description
filters	Array[dict]		Filter condition list when not log type
groupBy	Array[str]	Grouping information
funcName	string	Required	Aggregation function (required when qmode is selector mode for front-end echo), enumeration ("count", "avg", "max", "sum", "min", "count_distinct", "p75", "p95", "p99")
fieldKey	string	Required	Aggregation field (required when qmode is selector mode for front-end echo)
index	string		Index name when log type
source	string		This field represents different meanings in different types: Log type: source source, Application Performance type: service service, User Access type: application app_id, Metrics type: measurement, Security Check: category category
filterString	string		Filter condition when log type, original filter string, example: 'host:hangzhou123 -service:coredns internal:true'

Note: All fields in the extend field are only used for front-end echo display, and the actual metric generation query statement follows the query information configured in jsonScript.query.

6. Main structure explanation of extend.filters

Parameter Name	type	Description
condition	string	Relationship with the previous filter condition, possible values: `and`, `or`; default value: `and`
name	string	Field name to be filtered
op	string	Operator, possible values: `=`, `!=`, `match`, `not match`
values	array	Value list
values[#]	string/int/boolean	Can be string/numeric/boolean type, during data comparison it will take specific elements from `values` based on `operation`, for example, if `operation` is `=`, only values[0] participates in the operation

6.1 Example of extend.filters:

[
  {
      "name": "A",
      "condition": "and",
      "op": "match",
      "values": ["error"]
  },
  {
      "name": "tagC",
      "condition": "and",
      "op": "=",
      "values": ["ok"]
  }
]

7. **Overall structure example:

name="__codelineno-1-1"> { "extend": { "filters": [], "groupBy": ["host_ip"], "funcName": "count", "fieldKey": "*", "index": "default", "source": "*", "filterString": "host:hangzhou123 region:guanzhou" }, "jsonScript": { "type": "logToMetric", "metricInfo": { "every": "1m", "metric": "test", "metricField": "001-test", "unit": "custom/[\"timeStamp\",\"ms\"]", "desc": "" }, "query": { "q": "L('default')::RE(`.*`):(count(`*`)) { `host`='hangzhou123' and `region`='guanzhou' } BY `host_ip`", "qtype": "dql" } } }

Request Example¶

curl 'https://openapi.guance.com/api/v1/objc_cfg/create' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"extend":{"filters":[],"groupBy":["host_ip"],"funcName":"count","fieldKey":"*","index":"default","source":"*","filterString":"host:hangzhou123 region:guanzhou"},"jsonScript":{"type":"logToMetric","metricInfo":{"every":"1m","metric":"test","metricField":"001-test","unit":"custom/[\"timeStamp\",\"ms\"]","desc":""},"query":{"q":"L('default')::RE(`.*`):(count(`*`)) { `host`='hangzhou123' and `region`='guanzhou'  } BY `host_ip`","qtype":"dql"}}}' \
--compressed

Response¶

{
    "code": 200,
    "content": {
        "workspaceUUID": "wksp_xxxx",
        "monitorUUID": "",
        "updator": null,
        "type": "aggs",
        "refKey": "",
        "secret": null,
        "jsonScript": {
            "type": "logToMetric",
            "metricInfo": {
                "every": "1m",
                "metric": "test",
                "metricField": "001-test",
                "unit": "custom/[\"timeStamp\",\"ms\"]",
                "desc": ""
            },
            "query": {
                "q": "L('default')::RE(`.*`):(count(`*`)) { `host`='hangzhou123' and `region`='guanzhou'  } BY `host_ip`",
                "qtype": "dql"
            }
        },
        "crontabInfo": {
            "id": "cron-4VdviPep3oHc",
            "crontab": null
        },
        "extend": {
            "filters": [],
            "groupBy": [
                "host_ip"
            ],
            "funcName": "count",
            "fieldKey": "*",
            "index": "default",
            "source": "*",
            "filterString": "host:hangzhou123 region:guanzhou"
        },
        "createdWay": "manual",
        "isLocked": false,
        "openPermissionSet": false,
        "permissionSet": [],
        "id": null,
        "uuid": "rul_xxxx",
        "status": 0,
        "creator": "acnt_xxxx",
        "createAt": 1734594428,
        "deleteAt": -1,
        "updateAt": null,
        "__operation_info": {
            "uuid": "rul_xxxx"
        }
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "1111139030457458757"
}