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

云日志服务Java SDK(log4j )

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

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

使用前提

  • 使用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:请参见:我的凭证 用户指南。
  • 访问密钥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

提交反馈 取消

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

智能客服提问云社区提问