Elasticsearch：使用 Elastic APM 监控 Android 应用程序（二）

news/2024/11/14 23:58:25/

在我之前的文章 “Elasticsearch：使用 Elastic APM 监控 Android 应用程序（一）” 中，我详述了如何使用 Elastic APM 来监控 Android 应用程序。在今天的文章中，我来详述如何部署 Elastic Stack，并使用文章中的示例代码来进行展示。为了展示方便，在今天的展示中，我将所有的组件都安装到同一台机器 macOS 上。它的 private IP 地址为 192.168.0.3。

使用 Elastic APM 监控 Android 应用程序

APM 集成架构

Elastic APM 集成由四个组件组成：APM 代理、Elastic APM 集成、Elasticsearch 和 Kibana。 通常，这四个组件可以通过两种方式协同工作。边缘机器上的 APM 代理将数据发送到集中托管的 APM 集成：

​

在本演示中，我们的边缘设备也即 macOS。它通过 Elastic APM agent 采集信息，并传输到一个中央的 APM 集成。

在本次的演示中，我将使用最新的 Elastic Stack 8.7.0 来进行展示。

安装

Elastic Stack

 我们先按照我之前的文章：

  • 如何在 Linux，MacOS 及 Windows 上进行安装 Elasticsearch

  • Kibana：如何在 Linux，MacOS 及 Windows 上安装 Elastic 栈中的 Kibana

来安装 Kibana 及 Elasticsearch。不过在安装的时候，我们需要做一些调整。在启动 Elasticsearch 之前，我们还必须针对 Elasticsearch 的配置文件做一项修改：

config/elasticsearch.yml

xpack.security.authc.api_key.enabled: true

我们把上面的配置添加到 config/elasticsearch.yml 文件的最后面。这个是为了能够我们使用 API key 的方式来访问 Elasticsearch。修改完毕后，我们启动 Elasticsearch。

我们还必须为 Kibana 做一项修正。我们首先在 Kibana 的安装目录中使用如下的命令：

xpack.encryptedSavedObjects.encryptionKey: 5834bb75e1e8eaa4794439d228a0fe65
xpack.reporting.encryptionKey: d2a1337320c79c038f279167adc1a9ee
xpack.security.encryptionKey: 7cde0c75b035a99d000ed20b1e84b530

我们把上面的三个 keys 拷贝并粘贴到 config/kibana.yml 文件的最后面：

config/kibana.yml

​

添加完毕后，我们重新启动 Kibana。

Kibana 需要 Internet 连接才能从 Elastic Package Registry 下载集成包。 确保 Kibana 服务器可以连接到端口 443 上的 https://epr.elastic.co。如果你的环境有网络限制，则有一些方法可以解决此要求。 有关详细信息，请参阅气隙环境。

另外，我们必须注意的一点是 Fleet 在目前只供具有 superuser 角色的用户使用。Fleet 是 Kibana 中的界面。它被用来管理及监控 Elastic Agents。

Android Studio

如果你还没有安装好自己的 Android Studio，请到地址 https://developer.android.com/studio 去下载最新的发布，并进行相应的安装。

配置 Fleet

使用 Kibana 中的 Fleet 来添加对 Elastic agent 的管理。第一次使用 Fleet 时，你可能需要对其进行设置并添加 Fleet Server。要部署自我管理的 Fleet Server，请安装 Elastic Agent 并将其注册到包含 Fleet Server 集成的代理策略中：

​

​ 

​  

​ 

如上所示，我们在成功地创建 Fleet server policy 之后，然后选择相应的操作系统来安装 Elastic Agent。针对我的架构，我安装 Elastic Agent 到我的 macOS 电脑上：

curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.7.0-darwin-x86_64.tar.gz
tar xzvf elastic-agent-8.7.0-darwin-x86_64.tar.gz
cd elastic-agent-8.7.0-darwin-x86_64
sudo ./elastic-agent install \--fleet-server-es=https://192.168.0.3:9200 \--fleet-server-service-token=AAEAAWVsYXN0aWMvZmxlZXQtc2VydmVyL3Rva2VuLTE2ODE4MjkwODAxMzQ6LVo1OHN0Z2ZSNXlkOE5ZM3k5Tmd3dw \--fleet-server-policy=fleet-server-policy \--fleet-server-es-ca-trusted-fingerprint=9f268b75e5b9644109a69007310a97e0244fa86e7e80b3a50c55f937e38c7a66

​​

 如果你之前在自己的电脑上已经安装过，你可以去相应的目录中先进行卸载。针对 macOS：

$ su
Password:
$ cd /Library/Elastic/Agent/
$ ./elastic-agent uninstall
Elastic Agent will be uninstalled from your system at /Library/Elastic/Agent. Do you want to continue? [Y/n]:y
Elastic Agent has been uninstalled.

针对 Linux OS：

liuxg@liuxgu:~$ su
Password: 
root@liuxgu:/home/liuxg# cd /opt/Elastic/Agent/
root@liuxgu:/opt/Elastic/Agent# ./elastic-agent uninstall
Elastic Agent will be uninstalled from your system at /opt/Elastic/Agent. Do you want to continue? [Y/n]:y
I0418 10:31:42.996703    3635 leaderelection.go:248] attempting to acquire leader lease default/elastic-agent-cluster-leader...
Elastic Agent has been uninstalled.

​

稍等一会儿，我们就可以看到 liuxgm.local，也就是我的 macOS 机器上的 Agents 状态显示为 Healthy。我们点击 Fleet Server Policy： 

 ​ 

​  

​  

​ 

​ 

​ 

​

从上面，我们可以看出我们已经成功地部署了 APM 服务器。

接下来，我们可以开始部署 APM agents 了。

直到这一步，我们可以查看我们已经启动的端口：

$ netstat -an | grep LISTEN | grep 8200
tcp4       0      0  192.168.0.3.8200       *.*                    LISTEN     
$ netstat -an | grep LISTEN | grep 8220
tcp46      0      0  *.8220                 *.*                    LISTEN     
$ netstat -an | grep LISTEN | grep 8080
$ netstat -an | grep LISTEN | grep 8080
tcp46      0      0  *.8080                 *.*                    LISTEN

配置 APM agents

我们首先去地址 GitHub - elastic/sample-app-android-apm: Sample app to show the Elastic APM implementation on Android apps 下载源码：

git clone https://github.com/elastic/sample-app-android-apm

然后，我们使用如下的命令来 check out uninstrumented 分支：

cd sample-app-android-apm
git checkout uninstrumented

我们需要重新配置这个 backend。在默认的情况下，它不能连接到 Elasticsearch。我们必须修改如下如下的配置文件：

backend/src/main/resources/elasticapm.properties

service_name=weather-backend
application_packages=co.elastic.apm.android.sample
server_url=http://192.168.0.3:8200
secret_token=YOUR_ELASTIC_APM_SECRET_TOKEN

你需要根据自己的 APM server 地址修改上面的地址。

启动应用程序

我们接下来启动应用程序。我们需要在应用程序中进行一些配置。

1） 按照 Elastic APM Android Agent 的设置指南进行操作：

将 co.elastic.apm.android 插件添加到 app/build.gradle 文件（请确保使用该插件的最新版本，你可以在此处找到该插件）。

通过在 app/build.gradle 文件的 “elasticAPM” 部分中提供 “serverUrl” 和 “secretToken” 来配置代理与 Elastic APM 后端的连接。

// Android app's build.gradle file
plugins {//...id "co.elastic.apm.android" version "[latest_version]"
}//...elasticApm {// Minimal configurationserverUrl = "https://your.elastic.apm.endpoint"// OptionalserviceName = "weather-sample-app" serviceVersion = "0.0.1" secretToken = "your Elastic APM secret token" 
}

在我们的设计中，我们没有使用 token，所以上面的 secretToken 可以不设置或者可以为任意字符串。如果你想设置 secretToken，请参阅我之前的文章 “Obsevability：安全的 APM 服务器访问”。

2）唯一实际需要更改的代码是一行代码，用于在 Application.onCreate 方法中初始化 Elastic APM Android 代理。 此示例应用程序的应用程序类位于 app/src/main/java/co/elastic/apm/android/sample/MyApp.kt。

package co.elastic.apm.android.sampleimport android.app.Application
import co.elastic.apm.android.sdk.ElasticApmAgentclass MyApp : Application() {override fun onCreate() {super.onCreate()ElasticApmAgent.initialize(this)}
}

3）我们也同时需要修改如下地址的一个文件：

app/src/main/java/co/elastic/apm/android/sample/network/WeatherRestManager.kt

package co.elastic.apm.android.sample.networkimport co.elastic.apm.android.sample.network.data.ForecastResponse
import retrofit2.Retrofit
import retrofit2.converter.gson.GsonConverterFactoryobject WeatherRestManager {private val service: CityWeatherService by lazy {val retrofit = Retrofit.Builder().baseUrl("http://192.168.0.3:8080/v1/").addConverterFactory(GsonConverterFactory.create()).build()retrofit.create(CityWeatherService::class.java)}suspend fun getCurrentCityWeather(city: String): ForecastResponse {return service.getCurrentWeather(city)}
}

如上所示，我们需要修改上面的 APM server 地址。

我们准备启动演示。 （该 demo 旨在使用 Android 模拟器在本地环境中执行。）因此，我们需要：

  1. 在位于示例项目根目录的终端中使用此命令启动后端服务：./gradlew bootRun（如果你使用的是 Windows，则为 gradlew.bat bootRun）。 或者，你可以从 Android Studio 启动后端服务。
  2. 在 Android 模拟器（来自 Android Studio）中启动天气示例应用程序。

我们在 Android Studio 里运行 android 应用：

我们可以看到如下的模拟器：

 点击 Next 按钮：

我们尝试其它城市的选择。当我们选择 New York 城市的时候，我们可以看到如下的错误：

我们回到 APM 的界面：

从上面的图中，我们可以看到两个服务。我们点击 Service map：

很显然这个是一个收费的功能。我们需要打开试用功能：

这样就完成了试用的启动。我们再次回到 Service map 界面：

点击上面的 weather-sample-app：

其它的画面可以参考文章 “Elasticsearch：使用 Elastic APM 监控 Android 应用程序（一）”。


http://www.ppmy.cn/news/45191.html

相关文章

TensorFlow 智能移动项目：1~5

TensorFlow 智能移动项目：1~5

原文：Intelligent mobile projects with TensorFlow 协议：CC BY-NC-SA 4.0 译者：飞龙 本文来自【ApacheCN 深度学习 译文集】，采用译后编辑（MTPE）流程来尽可能提升效率。 不要担心自己的形象，只…
阅读更多...
通信行业的企业如何与Synaptics建立EDI连接？

通信行业的企业如何与Synaptics建立EDI连接？

Synaptics 是一家全球领先的移动计算、通信和娱乐设备人机界面交互开发解决方案设计制造公司。该公司为大部份主要电脑及笔记本电脑公司提供触摸板，其中包括了华硕、宏碁、戴尔、惠普、索尼、东芝、Gateway、国际商业机器、联想集团与三星电子等。 Synaptics 推荐其…
阅读更多...
C#中的MemoryStream内存流

C#中的MemoryStream内存流

C#中的MemoryStream是一个实现了Stream类的内存流类，用于在内存中读写数据。它位于System.IO命名空间。 下面是一些常用的属性和方法： 属性 CanRead：获取一个值，该值指示当前流是否支持读取操作。CanSeek：获取一个值…
阅读更多...
【获奖案例巡展】信创先锋之星——浙江省某市区视频能力中心

【获奖案例巡展】信创先锋之星——浙江省某市区视频能力中心

为表彰使用大数据、人工智能等基础软件为企业、行业或世界做出杰出贡献和巨大创新的标杆项目，星环科技自2021年推出了“新科技 星力量” 星环科技科技实践案例评选活动，旨在为各行业提供更多的优秀产品案例，彰显技术改变世界的力量&#xff0…
阅读更多...
数仓选型对比

数仓选型对比

1、数仓选型对比如下(先列举表格，后续逐个介绍) 数仓应用目标产品特点适用于 适用数据类型数据处理速度性能拓展 实施难度运维难度性能优化成本传统数仓(SQLServer、Oracle等关系型数据库)面向主题设计的，为 分析数据而设计基于Oracle、 SQLServer、MyS…
阅读更多...
Winnolin PK参数及BE分析

Winnolin PK参数及BE分析

文章目录一、PK参数分析一、非房室模型分析方法操作1.创建数据模型2.建立字段映射3.选择模型参数4.设置参数单位（Units）5.选择输出参数6.执行，查看结果二、生物等效性分析1.创建数据模型2.建立字段映射3.执行查看结果一、PK参数分析 药代动力…
阅读更多...
华为手表开发：WATCH 3 Pro（20）传感器订阅 佩戴状态

华为手表开发：WATCH 3 Pro（20）传感器订阅 佩戴状态

华为手表开发：WATCH 3 Pro（20）传感器订阅 佩戴状态 初环境与设备鸿蒙开发文件夹：文件新增展示的文本标记index.hmlindex.css 传感器订阅index.js 本篇教程将会介绍如何在华为 WATCH 3 Pro 上使用鸿蒙可穿戴开发进行传感器订阅&…
阅读更多...
ISO9001质量管理体系认证咨询22步流程——上篇

ISO9001质量管理体系认证咨询22步流程——上篇

【ISO9001质量管理体系认证咨询22步流程——上篇】 1.制定ISO9001质量管理体系推行计划 推行计划一般包括以下内容：体系诊断（现状调查、识别）、成立ISO推行小组并组织相关培训、体系文件结构策划、程序文件编写、质量手册编写、三阶文件编写、…
阅读更多...
最新文章

Copyright @ 2022~2023