为快速开始使用 Log Service Java SDK,请按照如下步骤进行:
步骤 1 创建阿里云账号
为了访问阿里云日志服务,您需要有一个阿里云账号。如果没有,可首先按照如下步骤创建阿里云账号:
- 访问阿里云 官方网站,单击页面上的 [backcolor=transparent]注册有礼 按钮。
- 按照屏幕提示完成注册流程并进行实名认证。
为了更好地使用阿里云服务,建议尽快完成实名认证,否则部分阿里云服务将无法使用。具体实名认证流程,请参考
这里。
步骤 2 获取阿里云访问密钥
为了使用 Log Service Java SDK,您必须申请阿里云的
访问密钥。
登录阿里云
密钥管理页面。选择一对用于 SDK 的访问密钥对。如果没有,请创建一对新访问密钥,且保证它处于“启用”状态。有关如何创建访问密钥,参见
创建访问密钥。
该密钥对会在下面的步骤使用,且需要保管好,不能对外泄露。另外,您可以参考
SDK 配置 了解更多 SDK 如何使用访问密钥的信息。
步骤 3 创建一个日志服务项目和日志库
目前,Log Service Java SDK 还无法管理日志项目(project)和日志库(logstore),所以您需要在控制台上创建好日志库后才能使用 SDK 进行操作。
有关如何创建项目和日志库,参见
创建项目 和
创建日志库。
[backcolor=transparent]注意:
- 请确保使用同一阿里云账号获取阿里云访问密钥和创建日志项目及日志库。
- 关于日志的项目、日志库等概念请参考 Log 核心概念。
- Log 的 project 名称为日志服务全局唯一,而 logstore 名称在一个 project 下面唯一。
- Log 的 project 一旦创建则无法更改它的所属区域。目前也不支持在不同阿里云 Region 间迁移 Log project。
步骤 4 安装 Java 开发环境
目前,Log Java SDK 支持 J2SE 6.0 及以上的 Java 运行环境,您可以从
Java 官方网站 下载并按说明安装 Java 开发环境。
步骤 5 安装 Log Service Java SDK
在安装完 Java 开发环境后,您需要安装 Log Service Java SDK。目前,我们提供两种方式安装日志服务的 Java SDK:
建议使用
Apache Maven 获取最新版本的 SDK,您可以添加如下配置到您的 Maven 项目。
您也可以完整下载 Java SDK 软件包,然后在自己的 Java 项目中直接引用本地软件包。
- 从 这里 克隆 Java SDK 包(版本会定期更新,如需使用最新版本请使用 Maven)。
- 解压完整下载的包到指定的目录即可。Java SDK 是一个软件开发包,不需要额外的安装操作。
- 把 SDK 包中的所有 Jar 包(包括依赖的第三方包)添加到您的 Java 工程(具体操作请参照不同的 IDE 文档)。
步骤 6 开始一个新的 Java 项目
现在,您可以开始使用 SDK Java SDK。使用任何文本编辑器或者 Java IDE,运行如下示例代码即可与 Log Service 服务端交互并得到相应输出。