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

云日志服务Java SDK(log4j )

分享
更新时间:2021/01/19 GMT+08:00

云日志服务SDK提供了与log4j适配的扩展插件,可以直接在log4j中配置华为云appender,将通过log4j产生的日志直接上报至华为云日志服务后台。

传输协议

HTTPS

使用前提

  • 使用log4j Java SDK前,您需要注册华为云账号且开通云日志服务。
  • 在云日志服务中已创建日志组(LogGroup)以及日志流(LogStream)。

使用步骤

  1. 下载并安装log4j Java SDK

    1. 下载SDK后解压到指定目录。注:直接解压即可,不需要额外操作。
    2. 将解压后的所有jar包添加到您的java工程,并配置log4j.properties中所列项。

  2. 配置log4j.properties。

    //配置自定义appender作用的package范围,将{xxx}配置为希望上报日志的package。
    log4j.logger.{xxx}=INFO,LOGSDK
    log4j.appender.LOGSDK =com.huawei.appender.LogSDKAppender
    log4j.appender.LOGSDK.layout=org.apache.log4j.PatternLayout 
    log4j.appender.LOGSDK.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n
    //上报日志所属日志服务的日志组ID(必选)
    log4j.logger.huaweiAppender.loggroupid=xxxxx-xxxx-xxx-xxxx-xxxx
    //上报日志所属日志服务的日志流ID(必选)
    log4j.logger.huaweiAppender.logstreamid=xxxxx-xxxx-xxx-xxxx-xxxx
    //当前租户的项目ID(必选)
    log4j.logger.huaweiAppender.projectid=xxxxxxxxxx
    //当前租户的访问密钥access key(必选)
    log4j.logger.huaweiAppender.ak=xxxxxyyyyyyyyy123
    //当前租户的访问密钥secret access key(必选)
    log4j.logger.huaweiAppender.sk=xxxxxyyyyyyyyy123
    //IAM鉴权地址 (必选)
    log4j.logger.huaweiAppender.iamendpoint=xx.63.21.37:xxxx(或者域名)
    //对应region上报日志的地址(必选)
    log4j.logger.huaweiAppender.endpoint=xx.xxx.xx.xx:0000
    //日志批量上报的条数大小(可选)
    log4j.logger.huaweiAppender.batchsize=100
    //日志上报的并发线程(可选)
    log4j.logger.huaweiAppender.threadcount=1
    //日志上报的队列大小(可选)
    log4j.logger.huaweiAppender.dataqueuesize=100000
    //发送日志的应用所在节点ip(可选) 
    log4j.logger.huaweiAppender.hostip=1.1.1.1
    //发送日志的应用所在节点name(可选) 
    log4j.logger.huaweiAppender.hostname=testsdk
    • log4j.properties不能更改名称,否则初始化时无法读取到相关配置信息。
    • 必选参数请参考:参数获取方法,获取后进行填写。

  3. 使用示例

    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    
    public class testAppender 
    {
        private static final Logger LOGGER =       LoggerFactory.getLogger(testAppender.class);
        public static void main(String[] args) 
       {
            LOGGER.info("test log appender");
        }
    }

参数获取方法

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

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

    • 项目ID/ProjectID:请参见:我的凭证
    • 访问密钥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

分享:

    相关文档

    相关产品

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

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问