传输协议

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：请参见“我的凭证 > 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