日志管理

阅读本文，您可以获取 Java SDK 日志管理的接口调用示例，实现快速开发。

调用说明

• 本文提供的接口调用示例均通过 AK 和 SK 初始化实例。
• 接口的参数说明和错误码等信息可通过接口文档或打开 API Explorer 的文档说明页签查看。

前提条件

调用接口前，请先完成 Java SDK 的安装及初始化操作

调用示例

本节为您介绍日志管理相关接口的功能和调用示例。

查询日志文件信息

您可以调用 DescribeLiveLogData 接口查询日志文件信息。详细的参数说明可参见 DescribeLiveLogData 接口文档。

接口调用示例如下所示。

package com.volcengine.live.demo;
import com.volcengine.model.live.v20230101.DescribeLiveLogDataBody;
import com.volcengine.model.live.v20230101.DescribeLiveLogDataRes;
import com.volcengine.service.live.v20230101.LiveService;
import java.util.ArrayList; 
import java.util.List; 

public class DescribeLiveLogDataDemo  {
  public static void main(String[] args) {
    // 强烈建议不要把 AccessKey ID 和 AccessKey Secret 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。
    // 本示例通过从环境变量中读取 AccessKey ID 和 AccessKey Secret，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 ACCESS_KEY_ID 和 ACCESS KEY_SECRET
    LiveService service = LiveService.getInstance();

    service.setAccessKey(System.getenv("ACCESS_KEY_ID"));

    service.setSecretKey(System.getenv("ACCESS_KEY_SECRET"));

    DescribeLiveLogDataBody body = new DescribeLiveLogDataBody();
     
    // 查询的开始时间，RFC3339 格式的 UTC 时间，精度为秒。
    // note：
    // <li> 当前仅支持查询最近 31 天的日志数据。 </li>
    // <li> 日志文件以整小时进行拆分，请确保查询的开始和结束时间包含所查询时段的整点小时时间。例如，如需查询某日 07:30:00-08:10:00 日志数据，日志查询开始时间应早于 07:00:00，结束时间应晚于 09:00:00。 </li>
    body.setStartTime("2022-04-13T10:00:00+08:00");
    
    // 查询的结束时间，RFC3339 格式的 UTC 时间，精度为秒。
    body.setEndTime("2022-04-13T11:00:00+08:00");
    
    // 域名列表，缺省情况下表示当前用户的所有推流域名和拉流域名。
    // note：
    // 日志类型为拉流转推日志（Type=relay）时，该参数无效。
    List<String> DescribeLiveLogDataBodyDomainList = new ArrayList<>(); 

    DescribeLiveLogDataBodyDomainList.add("example.com");
    DescribeLiveLogDataBodyDomainList.add("example2.com");
    
    body.setDomainList(DescribeLiveLogDataBodyDomainList); 
    
    // 日志类型，支持的类型如下所示。
    // <li> pull：拉流日志 </li>
    // <li> push：推流日志 </li>
    // <li> source：回源日志 </li>
    // <li> relay：拉流转推日志 </li>
    body.setType("pull");
    
    // 查询数据的页码，默认为 1，表示查询第一页的数据。
    body.setPageNum(1);
    
    // 每页显示的数据条数，默认为 20，最大值为 1000。
    body.setPageSize(20);

    try {
      DescribeLiveLogDataRes resp = service.describeLiveLogData(body);
      System.out.println(resp);
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}