create_logtail_config - Simple Log Service - Alibaba Cloud Documentation Center

Creates a Logtail configuration.

Request syntax

aliyunlog log create_logtail_config --project_name=<value> --config_detail=<value> [--access-id=<value>] [--access-key=<value>] [--sts-token=<value>] [--region-endpoint=<value>] [--client-name=<value>] [--jmes-filter=<value>] [--format-output=<value>] [--decode-output=<value>]

Request parameters

The following table describes the required and specific parameters of the create_logtail_config command.

Parameter	Type	Required	Example	Description
--project_name	String	Yes	test	The name of the project.
--config_detail	String	Yes	file://./logtailconfig.json	The path of the Logtail configuration file. For more information, see Logtail configurations.

For information about the global parameters of the Log Service command-line interface (CLI), see Global parameters.

Examples

Create the logtailconfig.json file in which the Logtail configuration is named config_name2. The following example shows the content of the createshipper.json file:

{
  "config_name": "config_name2",
  "logstore_name": "logstore-a",
  "file_pattern": "file_pattern",
  "time_format": "time_format",
  "log_path": "/log_path",
  "endpoint": "endpoint",
  "log_parse_regex": "xxx ([\\w\\-]+\\s[\\d\\:]+)\\s+(.*)",
  "log_begin_regex": "xxx.*",
  "reg_keys": [
    "time",
    "value"
  ],
  "topic_format": "none",
  "filter_keys": [
    "time",
    "value"
  ],
  "filter_keys_reg": [
    "time",
    "value"
  ],
  "logSample": "xxx 2017-11-11 11:11:11 hello alicloud."
}

Use the default account to create a Logtail configuration whose name is config_name2.

aliyunlog log create_logtail_config --project_name="aliyun-test-project" --config_detail="file://./logtailconfig.json"

Query the created Logtail configuration. Run the following command:

aliyunlog log get_logtail_config --project_name="aliyun-test-project" --config_name="config_name2"

The following output is returned:

{ "configName": "config_name2",
  "createTime": 1622118681,
  "inputDetail": {
    "adjustTimezone": false,
    "delayAlarmBytes": 0,
    "delaySkipBytes": 0,
    "discardNonUtf8": false,
    "discardUnmatch": true,
    "dockerFile": false,
    "enableRawLog": false,
    "enableTag": false,
    "fileEncoding": "utf8",
    "filePattern": "file_pattern",
    "filterKey": [
      "time",
      "value"
    ],
    "filterRegex": [
      "time",
      "value"
    ],
    "key": [
      "time",
      "value"
    ],
    "localStorage": true,
    "logBeginRegex": "xxx.*",
    "logPath": "/log_path",
    "logTimezone": "",
    "logType": "common_reg_log",
    "maxDepth": 1000,
    "maxSendRate": -1,
    "mergeType": "topic",
    "preserve": true,
    "preserveDepth": 0,
    "priority": 0,
    "regex": "xxx ([\\w\\-]+\\s[\\d\\:]+)\\s+(.*)",
    "sendRateExpire": 0,
    "sensitive_keys": [],
    "tailExisted": false,
    "timeFormat": "time_format",
    "topicFormat": "none"
  },
  "inputType": "file",
  "lastModifyTime": 1622118681,
  "logSample": "xxx 2017-11-11 11:11:11 hello alicloud.",
  "outputDetail": {
    "endpoint": "cn-hangzhou-b-intranet.log.aliyuncs.com",
    "logstoreName": "logstore-a",
    "region": "cn-hangzhou-b"
  },
  "outputType": "LogService"
}

Error codes

If an error message is returned, fix the error based on the error codes of the related API operation. For more information, see Error codes.

API reference

CreateConfig