调用CLI命令写入日志

更新时间:
复制 MD 格式

调用CLI命令向指定Logstore写入JSON格式的日志数据。

注意事项

在使用CLI命令之前,您需要注意以下事项:

  • 已开通日志服务。

  • 已安装日志服务CLI安装与配置

  • 已创建日志服务ProjectLogstore。

  • __time__ 字段的值必须为字符串类型的Unix时间戳(秒)。

命令格式

aliyun sls put-json-logs --project=<value> --logstore=<value> --logs <value> [--logs <value> ...] [--topic=<value>] [--source=<value>]

命令参数

该命令的必选和特有参数描述如下。

参数名称

数值类型

是否必选

示例值

描述

--project

String

aliyun-test-project

Project名称。

--logstore

String

aliyun-test-logstore

Logstore名称。

--logs

String

见示例

JSON格式的日志内容。可多次使用以写入多条日志。

--topic

String

app-server

日志主题标签,用于分类日志。

--source

String

192.168.1.10

日志来源标签,如服务器IP。

关于该命令的全局参数,请参见全局参数。

命令示例

写入单条日志

  • 命令示例

aliyun sls put-json-logs --project="aliyun-test-project" --logstore="aliyun-test-logstore" \
  --logs '{"__time__":"1715769600", "region":"cn-hangzhou", "content":"hello aliyun cli"}'
  • 返回示例

命令执行成功后,无响应消息。

写入多条日志

  • 命令示例

aliyun sls put-json-logs --project="aliyun-test-project" --logstore="aliyun-test-logstore" \
  --logs '{"__time__":"1715769600", "region":"cn-hangzhou", "content":"log entry 1"}' \
  --logs '{"__time__":"1715769601", "region":"cn-hangzhou", "content":"log entry 2"}'
  • 返回示例

命令执行成功后,无响应消息。

写入日志(指定topicsource)

  • 命令示例

aliyun sls put-json-logs --project="aliyun-test-project" --logstore="aliyun-test-logstore" \
  --logs '{"level":"info","msg":"服务启动成功"}' \
  --topic "app-server" \
  --source "192.168.1.10"
  • 返回示例

命令执行成功后,无响应消息。

相关文档

  • 在调用API接口过程中,若服务端返回结果中包含错误信息,则表示调用API接口失败。您可以参考API错误码对照表查找对应的解决方法。更多信息,请参见PutLogs

  • 阿里云OpenAPI开发者门户提供调试、SDK、示例和配套文档。通过OpenAPI,您无需手动封装请求和签名操作,就可以快速对日志服务API进行调试。更多信息,请参见OpenAPI开发者门户

API参考

写入日志