You need to enable JavaScript to run this app.
导航
快速开始
最近更新时间:2023.11.14 19:17:37首次发布时间:2023.04.27 17:58:57

本文介绍如何快速使用日志服务 Android SDK 实现基础的日志采集流程。

前提条件

已安装日志服务 Android SDK。更多信息,请参见安装 SDK

注意事项

日志服务的日志上传基于 http 协议,而 Android 11.0 使用 HttpUrlConnection 进行 http 请求会出现以下异常。

W/System.err: java.io.IOException: Cleartext HTTP traffic to **** not permitted

对于 Android 11.0 及后续版本版本,需要执行以下操作:

  1. 在项目的 res 文件夹下创建一个名为 xml 的文件夹,然后创建 network_security_config.xml 文件。
    文件内容如下,其中 tls-cn-beijing.volces.com 应修改为实际使用的服务地址。

    <?xml version="1.0" encoding="utf-8"?>
    <network-security-config>
        <!--<base-config cleartextTrafficPermitted="true" />-->
        <domain-config cleartextTrafficPermitted="true">
            <domain includeSubdomains="true">tls-cn-beijing.volces.com</domain>
        </domain-config>
    </network-security-config>
    
  2. 修改 AndroidManifest.xml 文件,在 application 标签中增加以下属性:

    <application
        ...
        android:networkSecurityConfig="@xml/network_security_config"
        ...
    />
    

示例项目

日志服务在 GitHub 中提供了一个开源的日志采集示例项目 android-demo 供您参考。您可以通过此示例项目测试日志服务 Android SDK 的日志采集能力,跑通日志采集流程。

  1. 通过示例项目创建 Android 应用程序。
    1. 在 GitHub 中下载示例项目的源码。
    2. 通过 Android Studio 创建项目,并导入源码文件。
    3. PutLogExample.java 文件的属性部分中配置火山引擎密钥及 Topic ID 等信息。
  2. 测试应用程序的日志采集能力。
    1. 将 Android 设备连接至计算机。
    2. 在 Android Studio 里点击 Run 'app'
      成功运行后,示例项目会安装到指定 Android 设备中。
    3. 启动 App,并根据提示发送日志。
      日志服务 Android SDK 会采集应用程序的日志数据,并自动发送至指定的日志主题中,您可以在日志服务控制台中预览这些日志数据。