Create¶

POST /api/v1/aggs_to_metric/add

Overview¶

Create a new metric generation rule.

Body Request Parameters¶

Parameter Name	Type	Required	Description
extend	json	Y	Additional information Allow empty: False
jsonScript	json	Y	Rule configuration Allow empty: False
jsonScript.type	string	Y	Type Example: rumToMetric Allow empty: False Allow empty string: False Allowed values: ['logToMetric', 'rumToMetric', 'apmToMetric', 'metricToMetric', 'securityToMetric', 'dialingToMetric']
jsonScript.query	json	Y	DQL query related information Allow empty: False
jsonScript.metricInfo	json	Y	Metric configuration information Allow empty: False
jsonScript.metricInfo.every	string	Y	Frequency Example: 5m Allow empty string: False
jsonScript.metricInfo.metric	string	Y	Measurement name Example: cpu Allow empty string: False
jsonScript.metricInfo.metricField	string	Y	Metric name Example: load5s Allow empty string: False
jsonScript.metricInfo.unit	string		Unit Example: load5s Allow empty string: True
jsonScript.metricInfo.desc	string		Description Example: xxx Allow empty string: True
skipRepeatNameCheck	boolean		Whether to skip duplicate name check for measurement and metric. Default false. false means perform duplicate name check, true means skip duplicate name check. Example: false Allow empty: False

Parameter Supplementary Explanation¶

Request parameter description.

1. **jsonScript parameter description

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

2. jsonScript.type description

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

3. jsonScript.metricInfo description

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

3.1 jsonScript.metricInfo.unit unit description

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 Description

4. jsonScript.query description

Parameter Name	type	Required	Description
q	String	Required	Query statement
qtype	String		Query syntax type, dql/promql
qmode	String		Query type, selector: selectorQuery , manual: customQuery, this field affects the frontend query display style

5. **extend parameter description

Parameter Name	type	Required	Description
filters	Array[dict]		Filter condition list for non-log types
groupBy	Array[str]	Grouping information
funcName	string	Required	Aggregation function (required when qmode is selector mode, for frontend display), enum values("count", "avg", "max", "sum", "min", "count_distinct", "p75", "p95", "p99")
fieldKey	string	Required	Aggregation field (required when qmode is selector mode, for frontend display)
index	string		Index name for log type
source	string		This field represents different meanings in different types: Log type: source, APM type: service, RUM type: app_id, Metric type: measurement, Security Check: category
filterString	string		Filter condition for log type, original filter string, example: 'host:hangzhou123 -service:coredns internal:true'

Note: All fields in the extend field are only used for frontend display purposes. The actual metric generation query statement is based on the query information configured in jsonScript.query.

6. extend.filters main structure description

Parameter Name	type	Description
condition	string	Relationship with the previous filter condition, allowed values:`and`, `or`; Default: `and`
name	string	Field name to filter
op	string	Operator, allowed values: `=`, `!=`, `match`, `not match`
values	array	Value list
values[#]	string/int/boolean	Can be string/numeric/boolean type. During data comparison, specific elements from `values` will be taken for comparison based on the characteristics of `operation`. For example, when `operation` is `=`, only values[0] participates in the operation.

6.1 extend.filters example:

[
  {
      "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"
}