传输协议

HTTPS

使用前提

• 使用云日志SDK前，您需要注册华为云帐号且开通云日志服务。
• 需要获取待上报的日志服务所在华为云区域（Region）信息。

使用前配置

使用云日志服务SDK前，您需要进行ConnectionConfig类的初始化配置。配置内容如下：

1. 确认云日志服务的区域

   使用SDK前首先需要确认当前租户所在的Region（如“华北-北京-1”等），然后选择与其匹配的云日志服务区域。

2. 配置访问秘钥（AK/SK）

   日志SDK依赖AK（Access Key）和SK（Secret Access Key）进行鉴权，使用SDK前需要先获取AK/SK信息。

使用步骤

1. 获取华为云帐号的AK/SK，步骤参考：如何获取AK/SK。
2. 安装java开发环境，日志SDK支持JDK1.6以上开发环境。
3. 下载并安装日志SDK包
   1. 下载日志SDK包。
   2. 下载后解压到指定目录。注：直接解压即可，不需要额外操作。
   3. 将解压后的所有jar包添加到您的java工程。

4. 在云日志服务创建日志组和日志流。
5. 开始一个新的Java工程。

   public class sdkTest {
    
       //Demo演示程序
       public static void main(String[] args) {
           //初始化链接信息
           ConnectionConfig config = new ConnectionConfig();
           
           config.setProjectid("1c06fc5dc0814a4da1594a9ade9cb93c");       //当前租户的项目ID
           config.setLogGroupId("4927b522-67b4-4f9d-8320-8a5d7ebd2d61");  //发送日志所属日志组
           config.setLogStreamId("bda48df9-1fd1-43e6-a8fd-906fd600de2c"); //发送日志所属日志流
           
           //iam鉴权信息，鉴权通过了才能上报日志
           config.setAK("QINDZD28DSEZEOF3EFPX");                       //当前租户的Access key
           config.setSK("abc0WGkdXlhX40Z7R4dFsuK384ZhIIdFacIvWBqI");   //当前租户的Secret Access Key
           config.setIamEndpoint("iam.cn-north-7.ulanqab.huawei.com"); //当前region对应的IAM鉴权远端地址
           
           //发送参数设置
           config.setEndpoint("100.95.151.58:31003");//发送日志的远端IP地址和端口。
           config.setBatchSize(60);                  //设置每次发生日志条数
           config.setThreadCount(1);                 //设置同时发送日志的线程数量
           config.setDataQueueSize(10000);           //设置日志发生缓存队列大小。默认500000
      
           Producer producer;
           try {
               //根据配置信息，初始化日志发送的生产者
               producer = ProducerFactory.getInstance().createProceduer(config);
               
               //创建日志发送的结构体
               LogItem item = new LogItem();
               //填充需要发送的日志内容，以及日志发送当前时间，如果超过或滞后云服务的系统时间12小时（云服务采用东八区时间），则直接丢弃
               item.addLog(System.currentTimeMillis(), "hello world I am a software engineer.");
               try {
                   producer.sendData(item, new LogCallback() {
                       @Override
                       public void onCompletion(LogItem item, Exception exception) {
                           if (exception != null) {
                               System.out.println("send result: + " + exception.getMessage());
                           } else {
                               System.out.println("send result: success");
                           }
                       }
                   });
               } catch (Exception e) {
                   e.printStackTrace();
               }
           } catch (Exception e) {
               e.printStackTrace();
           }
       }
   } 

配置参数说明

ConnectionConfig类方法参数介绍：

参数获取方法

• 日志组ID：登录云日志服务页面，选择日志管理，日志组名称下面的ID即为日志组ID。

  

• 日志流ID：单击日志组名称，跳转至日志流列表，日志流名称下面的ID即为日志流ID。

  

  • 项目ID/ProjectID：请参见“我的凭证 > API凭证”。
  • 访问密钥access key（AK）/secret access key（SK），请参见“我的凭证 > 访问密钥 ”。
  • 上报日志地址：不同服务不同区域的上报地址不同，请联系华为工程师。
  • IAM 鉴权地址如下表所示：

    区域名称	区域	终端节点（Endpoint）	协议类型
    global	global	iam.myhuaweicloud.com	HTTPS
    华北-北京二	cn-north-2	iam.cn-north-2.myhuaweicloud.com	HTTPS
    华北-北京四	cn-north-4	iam.cn-north-4.myhuaweicloud.com	HTTPS
    华北-北京一	cn-north-1	iam.cn-north-1.myhuaweicloud.com	HTTPS
    华东-上海二	cn-east-2	iam.cn-east-2.myhuaweicloud.com	HTTPS
    华东-上海一	cn-east-3	iam.cn-east-3.myhuaweicloud.com	HTTPS
    华南-广州	cn-south-1	iam.cn-south-1.myhuaweicloud.com	HTTPS
    华南-深圳	cn-south-2	iam.cn-south-2.myhuaweicloud.com	HTTPS
    西南-贵阳一	cn-southwest-2	iam.cn-southwest-2.myhuaweicloud.com	HTTPS