HTTPS 端点 API：发送日志

Site24x7 允许您通过 HTTPS 端点将日志发送到 AppLogs。

在通过 HTTPS 端点发送日志之前，请确保：

• 配置日志类型 – 创建新的日志类型，或从100 多种预定义日志类型中选择。请登录 Site24x7 并导航至管理 > AppLogs > 日志类型 > 添加日志类型。
• 启用 API 上传 – 如果您打算通过 HTTPS 端点发送日志，请在添加日志类型表单中启用 API 上传选项。
  
  

启用后，系统将生成一个带有参数的唯一 URL。您可以直接将日志数据发送到单行上传 URL。默认情况下，会包含一个 token 参数用于识别日志类型实体。下表列出了其他支持的参数以供参考：

完成上述步骤后，有以下三种方式将日志发送到 Site24x7 的 AppLogs：

• HTTPS 单行
• HTTPS 多行
• HTTPS 文件上传

HTTPS 单行

您可以以 JSON 格式将单行日志发送到 Site24x7 的 HTTPS 端点。

测试：

请通过运行您自己的应用程序发送日志，或使用以下示例来验证日志是否正确发送。

示例：

打开命令提示符，输入以下带有 JSON 值的 cURL 命令。

curl -X POST -H "Content-Type: application/json" -d "{\"_zl_timestamp\":1621246428715,\"LogLevel\":\"WARN\",\"Message\":\"Batch of prepared statements\"}" https://logc.site24x7.com/event/receiver?token=

其中，TokenValue 可在启用 API 上传后的特定日志类型页面上获取。日志行中的 'zl_timestamp' 字段为必填项，且必须为 Unix 时间戳格式。

您可以通过响应码 200 OK 验证 AppLogs 是否已收到您的测试数据。
要查看日志，请在 AppLogs 页面中按日志类型搜索。日志索引可能需要几分钟时间。

HTTPS 多行

您可以以 JSON 格式将多行日志发送到 Site24x7 的 HTTPS 端点，也可以发送多行异常堆栈跟踪。

测试：

请通过运行您自己的应用程序发送日志，或使用以下示例来验证日志是否正确发送。

示例：

打开命令提示符，输入以下带有 JSON 值的 cURL 命令。

curl -X POST -H "Content-Type: application/json" -d "[{\"_zl_timestamp\":1621246428715,\"LogLevel\":\"WARN\",\"Message\":\"Batch of prepared statements\"},{\"_zl_timestamp\":1621246428716,\"LogLevel\":\"WARN\",\"Message\":\"Batch of prepared statements\"},{\"_zl_timestamp\":1621246428716,\"LogLevel\":\"WARN\",\"Message\":\"Batch of prepared statements\"}]" https://logc.site24x7.com/event/receiver?token=

其中，TokenValue 可在启用 API 上传后的特定日志类型页面上获取。日志行中的 'zl_timestamp' 字段为必填项，且必须为 Unix 时间戳格式。

您可以通过响应码 200 OK 验证 AppLogs 是否已收到您的测试数据。
要查看日志，请在 AppLogs 页面中按日志类型搜索。日志索引可能需要几分钟时间。

HTTPS 文件上传

您还可以使用 Site24x7 的 HTTPS 端点上传日志文件。Site24x7 支持 JSON、ZIP 和 GZ 格式的文件。

测试：

请通过运行您自己的应用程序发送日志，或使用以下示例来验证日志是否正确发送。

示例：

打开命令提示符，输入以下带有 JSON 值的 cURL 命令。

curl -X POST -H "Content-Type: application/json" --data "@sample.json" https://logc.site24x7.com/event/receiver?token=

其中，TokenValue 可在启用 API 上传后的特定日志类型页面上获取。日志行中的 'zl_timestamp' 字段为必填项，且必须为 Unix 时间戳格式。

您可以通过响应码 200 OK 验证 AppLogs 是否已收到您的测试数据。
要查看日志，请在 AppLogs 页面中按日志类型搜索。日志索引可能需要几分钟时间。

直接从 AppLogs 搜索控制台上传文件

1. 登录 Site24x7，点击左侧窗格中的 AppLogs 标签页。
2. 点击查询字段最右侧的上传。
3. 在弹出窗口的下拉列表中选择您的日志类型。
4. 浏览并上传您的文件。
   
   
   

限制：

• 您可以通过 Site24x7 的 HTTPS 端点发送最近 30 天的日志。更早的日志可以上传，但无法被搜索到。
• 单次请求最多只能批量发送 5MB 的日志。

其他上传方式：

您也可以直接使用 AppLogs 代理将日志上传到 Site24x7。为此，您需要安装服务器监控代理，定义日志类型，将其与日志配置文件关联，然后开始上传日志。

故障排除步骤：

如果日志无法上传，可能是以下原因之一导致的：

相关文章：

• 使用 Site24x7 进行日志管理
• 启用日志管理
• 支持的日志类型
  
• 保存搜索查询