All Products
Document Center

Log Service:get_logtail_config

Last Updated:Oct 26, 2023

Queries a specified Logtail configuration.

Request syntax

aliyunlog log get_logtail_config --project_name=<value> --config_name=<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 get_logtail_config command.
--project_nameStringYesaliyun-test-projectThe name of the project.
--config_nameStringYesconfig_name2The name of the Logtail configuration.
For information about the global parameters of the Log Service command-line interface (CLI), see Global parameters.


  • Sample requests
    Use the default account to query a Logtail configurations named config_name2.
    aliyunlog log get_logtail_config --project_name="aliyun-test-project" --config_name="config_name2"
    To save the returned Logtail configuration to a specified file, run the following command:
    aliyunlog log get_logtail_config --project_name="aliyun-test-project" --config_name="config_name2" >>export_logtail_config.json
  • Sample responses
      "configName": "config_name2",
      "createTime": 1622119397,
      "inputDetail": {
        "adjustTimezone": false,
        "delayAlarmBytes": 0,
        "delaySkipBytes": 0,
        "discardNonUtf8": false,
        "discardUnmatch": true,
        "dockerFile": false,
        "enableRawLog": false,
        "enableTag": false,
        "fileEncoding": "utf8",
        "filePattern": "file_pattern",
        "filterKey": [
        "filterRegex": [
        "key": [
        "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": 1622119416,
      "logSample": "xxx 2017-11-11 11:11:11 hello alicloud.",
      "outputDetail": {
        "endpoint": "",
        "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 of GetConfig.

API reference