文档首页 > > 用户指南> SDK参考> 云日志服务Java SDK

云日志服务Java SDK

分享
更新时间: 2020/06/12 GMT+08:00

云日志服务SDK提供了Java语言上报日志的一系列方法,方便用户直接使用编码方式上报日志到云日志服务后台。

使用前提

  • 使用云日志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 {
    public static void main(String args[]){
        ConnectionConfig config = new ConnectionConfig();
        config.setLogGroup("xxx-xx-xxx-xx-xxxx");//发送日志所属日志组
        config.setLogStream("xx-xxxxx-xxx");//发送日志所属日志流
    config.setProjectid("xxxxxxxxxxx");//当前租户的项目ID
        config.setAK("xxxxx");//当前租户的Access key
        config.setSK("xxxxx");//当前租户的Secret Access Key
    config.setEndpoint("xx.xx.xx.xxx:xxx");//发送日志的目标endpoint
    config.setBatchSize(60);//设置日志批量处理的大小
    config.setThreadCount(10);//设置同时发送日志的线程数量
    config.setDataQueueSize(500*1000);//设置日志处理队列长度
    config.setIamEndpoint(“xx.xx.xx.xxxx”);//当前region对应的IAM鉴权endpoint
    Producer producer = ProducerFactory.getInstance().createProceduer(config);
    LogItem item = new LogItem();
    item.add(System.currentTimeMillis(),”xxxxxxxx”);//添加日志logItem。入参为日志产生时间和日志内容
    producer.sendData(item);//无回调方式发送
    try {
         producer.sendData(item, new LogCallback(){
          @Override
          public void onCompletion(LogItem item, Exception e){
            if(exception != null){……}
            else{……}});
         } catch (Exception e) {
           e.printStackTrace();
         }//有回调方式发送

配置参数说明

参数名称

参数说明

对应方法

取值举例

endPoint

对应Region上报日志的地址

SetEndPoint

xxx.y.z.xxx:xxx

region

租户所在的Region

setRegion

cn-north-4

ak

华为云租户的访问密钥access key

setAk

xxx-xx-xxx

sk

华为云租户访问密钥secret key

setSk

xxx-xx-xxx

projectId

当前租户的项目ID

setProjectId

abcdxxxx

threadCout

上报日志的并发线程数

setThreadCout

10(建议不超过20)

dataQueueSize

上报日志的缓存队列长度

setDataQueueSize

500000

resultHandQueueSize

日志结果信息队列数长度

setResultHandQueueSize

500000

batchSize

单次上报日志的条数

setBatchSize

1000(单条日志size* batchSize需要小于2MB,否则会发送失败。)

logGroup

上报日志所属的日志组

setLogGroup

aabdsfzx

version

上报日志目标日志流

setVersion

v1

sendType

上报日志方式

setSendType

Endpoint

hostIP

用户服务所在的节点IP地址

setHostIP

X.X.X.X

hostName

用户服务所在的节点名称

setHostName

Host1

参数获取方法

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

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

  • 项目ID:请参见:我的凭证 用户指南。
  • 访问密钥access key(AK)/secret access key(SK),请参见:我的凭证 用户指南。
  • 区域、IAM 鉴权地址和上报日志地址请参见下表:

    区域

    名称

    IAM鉴权地址

    上报日志地址

    华北-北京一

    cn-north-1

    iam.cn-north-1.myhuaweicloud.com

    请联系华为工程师获取

    华北-北京四

    cn-north-4

    iam.cn-north-4.myhuaweicloud.com

    请联系华为工程师获取

    华南-广州一

    cn-south-1

    iam.cn-south-1.myhuaweicloud.com

    请联系华为工程师获取

    华东-上海二

    cn-east-2

    iam.cn-east-2.myhuaweicloud.com

    请联系华为工程师获取

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问