步骤 3：安装 APM 代理

1. 将代理添加到您的项目

首先，将 Elastic APM 代理插件 添加到您的应用程序的 build.gradle 文件中，如下所示

// Android app's build.gradle file
plugins {
    id "com.android.application"
    id "co.elastic.apm.android" version "[latest_version]" 
}

2. 配置代理

添加代理插件后，对其进行配置。最小配置将 Elastic APM 集成端点设置为如下所示

// Android app's build.gradle file
plugins {
    //...
    id "co.elastic.apm.android" version "[latest_version]" 
}

elasticApm {
    // Minimal configuration
    serverUrl = "https://your.elastic.server"

    // Optional
    serviceName = "your app name" 
    serviceVersion = "0.0.0" 
    apiKey = "your server api key" 
    secretToken = "your server auth token" 
}

3. 初始化代理

在使用上述 Gradle 更改同步您的项目后，需要在您的 Application 类 中初始化 Elastic APM 代理。此示例展示了配置代理的最简单方法

// Your Application class

class MyApp extends android.app.Application {

    @Override
    public void onCreate() {
        super.onCreate();
        ElasticApmAgent.initialize(this); 
    }
}

剩下的就是编译并运行您的应用程序。就这样！

在代理参考中了解更多信息

在 APM Android 代理参考 中阅读更多内容。

1. 安装代理

使用 go get 安装 Elastic APM Go 代理包

go get -u go.elastic.co/apm/v2

2. 配置代理

为了简化开发和测试，代理默认将数据发送到位于 https://127.0.0.1:8200 的 Elastic APM 集成。要将数据发送到其他位置，您必须配置 ELASTIC_APM_SERVER_URL。

# The APM integration host and port
export ELASTIC_APM_SERVER_URL=

# If you do not specify `ELASTIC_APM_SERVICE_NAME`, the Go agent will use the
# executable name. For example, if your executable is called "my-app.exe", then your
# service will be identified as "my-app".
export ELASTIC_APM_SERVICE_NAME=

# Secret tokens are used to authorize requests to the APM integration
export ELASTIC_APM_SECRET_TOKEN=

3. 检测您的应用程序

检测是扩展应用程序代码以将跟踪数据报告到 Elastic APM 的过程。Go 应用程序必须在源代码级别手动检测。要检测您的应用程序，请使用以下方法之一

在代理参考中了解更多信息

1. 将代理依赖项添加到您的项目

将 Elastic APM iOS 代理添加到您的 Xcode 项目或您的 Package.swift 中。

以下是将 包依赖项 添加到标准 Xcode 项目的说明。

有关将依赖项添加到您的 Package.swift 的详细信息，请参阅 添加对另一个 Swift 包的依赖项。以下是一个有用的代码片段

Package(
    dependencies:[
         .package(name: "apm-agent-ios", url: "https://github.com/elastic/apm-agent-ios.git", from: "1.0.0"),
    ],
  targets:[
    .target(
        name: "MyApp",
        dependencies: [
            .product(name: "ElasticApm", package: "apm-agent-ios")
        ]
    ),
])

2. 初始化代理

如果您使用 SwiftUI 构建您的应用程序，请将以下内容添加到您的 App.swift 中

import SwiftUI
import ElasticApm

class AppDelegate : NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
        var config = AgentConfigBuilder()
            .withServerUrl(URL(string:"http://127.0.0.1:8200")) 
            .withSecretToken("<SecretToken>") 
            .build()

        ElasticApmAgent.start(with: config)
        return true
    }
}

@main
struct MyApp: App {
    @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
    init() {
    }
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

如果您不使用 SwiftUI，则可以将相同内容添加到您的 AppDelegate.swift 文件中

import UIKit
import ElasticApm
@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
var config = AgentConfigBuilder()
                       .withServerUrl(URL(string:"http://127.0.0.1:8200")) 
                       .withSecretToken("<SecretToken>") 
                       .build()
        ElasticApmAgent.start(with: config)
        return true
    }
}

在代理参考中了解更多信息

在 APM iOS 代理参考 中阅读更多内容。

使用 -javaagent JVM 选项手动设置和配置代理。不需要更改应用程序代码，但这需要重新启动应用程序。有关此设置方法的更多信息，请参见下文。

1. 下载 APM 代理

开始使用 Elastic APM Java 代理的第一步是获取代理 JAR 的副本。Java 代理版本发布到 Maven 中央仓库。为了获取副本，您可以

2. 添加 -javaagent 标志

启动应用程序时，添加 JVM 标志 -javaagent:/path/to/elastic-apm-agent-<version>.jar

3. 配置

不同的应用程序服务器具有不同的设置 -javaagent 标志和系统属性的方法。启动您的应用程序（例如 Spring Boot 应用程序或其他嵌入式服务器）并添加 -javaagent JVM 标志。使用 -D 前缀使用系统属性配置代理

java -javaagent:/path/to/elastic-apm-agent-<version>.jar -Delastic.apm.service_name=my-cool-service -Delastic.apm.application_packages=org.example,org.another.example -Delastic.apm.server_url=http://127.0.0.1:8200 -jar my-application.jar

有关更多信息，请参阅 使用 -javaagent 标志进行手动设置。

其他设置方法

设置 APM 代理

.NET 代理可以通过几种不同的方式添加到应用程序中

在代理参考中了解更多信息

1. 安装 APM 代理

将 APM 代理作为依赖项安装到您的 Node.js 应用程序中。

npm install elastic-apm-node --save

2. 初始化

在您要求 任何 其他模块（即在 http 之前以及在您的路由器之前等）之前启动代理非常重要。

这意味着您可能应该在应用程序的主文件中要求并启动代理（通常是 index.js、server.js 或 app.js）。

以下是如何通常要求和启动 Elastic APM 的简单示例

// Add this to the VERY top of the first file loaded in your app
var apm = require('elastic-apm-node').start({
  // Override service name from package.json
  // Allowed characters: a-z, A-Z, 0-9, -, _, and space
  serviceName: '',

  // Use if APM integration requires a token
  secretToken: '',

  // Use if APM integration uses API keys for authentication
  apiKey: '',

  // Set custom APM integration host and port (default: http://127.0.0.1:8200)
  serverUrl: '',
})

代理现在将监控应用程序的性能并记录任何未捕获的异常。

在代理参考中了解更多信息

1. 安装代理

使用 支持平台的包 之一安装代理。

要使用 RPM 包（RHEL/CentOS 和 Fedora）

rpm -ivh <package-file>.rpm

要使用 DEB 包（Debian 和 Ubuntu）

dpkg -i <package-file>.deb

要使用 APK 包（Alpine）

apk add --allow-untrusted <package-file>.apk

如果您找不到您的发行版，您可以通过从源代码构建代理来安装它。以下说明将使用 Elastic 用于构建我们的官方包的相同 Docker 环境来构建 APM 代理。

cd apm-agent-php
# for linux glibc - libc distributions (Ubuntu, Redhat, etc)
export BUILD_ARCHITECTURE=linux-x86-64
# for linux with musl - libc distributions (Alpine)
export BUILD_ARCHITECTURE=linuxmusl-x86-64
# provide a path to php-config tool
export PHP_CONFIG=php-config

# build extensions
make -f .ci/Makefile build

# run extension tests
PHP_VERSION=`$PHP_CONFIG --version | cut -d'.' -f 1,2` make -f .ci/Makefile run-phpt-tests

# install agent extensions
sudo cp agent/native/_build/${BUILD_ARCHITECTURE}-release/ext/elastic_apm-*.so `$PHP_CONFIG --extension-dir`

# install automatic loader
sudo cp agent/native/_build/${BUILD_ARCHITECTURE}-release/loader/code/elastic_apm_loader.so `$PHP_CONFIG --extension-dir`

2. 启用和配置 APM 代理

在 php.ini 文件中启用和配置您的代理

extension=elastic_apm_loader.so
elastic_apm.bootstrap_php_part_file=<repo root>/agent/php/bootstrap_php_part.php

在代理参考中了解更多信息

在代理参考中了解更多信息

1. 安装 APM 代理

将代理添加到您的 Gemfile 中。

gem 'elastic-apm'

2. 配置代理

在代理参考中了解更多信息

1. 启用实时用户监控 (RUM)

RUM 默认情况下处于禁用状态。通过将 Enable RUM 设置为 true 来启用它。

2. 设置代理

使用 <script> 标签或使用捆绑器来设置代理。

同步/阻塞模式

添加一个 <script> 标签来加载捆绑包并使用 elasticApm 全局对象来初始化代理

<script src="https://<your-cdn-host>.com/path/to/elastic-apm-rum.umd.min-<version>.js" crossorigin></script>
<script>
  elasticApm.init({
    serviceName: '<instrumented-app>',
    serverUrl: '<apm-server-url>',
  })
</script>

异步/非阻塞模式

异步加载脚本可确保代理脚本不会阻塞页面上的其他资源，但是，它仍然会阻塞浏览器的 onload 事件。

<script>
  ;(function(d, s, c) {
    var j = d.createElement(s),
      t = d.getElementsByTagName(s)[0]

    j.src = 'https://<your-cdn-host>.com/path/to/elastic-apm-rum.umd.min-<version>.js'
    j.onload = function() {elasticApm.init(c)}
    t.parentNode.insertBefore(j, t)
  })(document, 'script', {serviceName: '<instrumented-app>', serverUrl: '<apm-server-url>'})
</script>

使用捆绑器

将实时用户监控 APM 代理作为依赖项安装到您的应用程序中

npm install @elastic/apm-rum --save

配置代理

import { init as initApm } from '@elastic/apm-rum'

const apm = initApm({

  // Set required service name (allowed characters: a-z, A-Z, 0-9, -, _, and space)
  serviceName: '',

  // Set custom APM integration host and port (default: https://127.0.0.1:8200)
  serverUrl: 'https://127.0.0.1:8200',

  // Set service version (required for sourcemap feature)
  serviceVersion: ''
})

在代理参考中了解更多信息

Elastic 与 OpenTelemetry 集成，允许您重用现有的仪器来轻松地将可观察性数据发送到 Elastic Stack。

有关如何结合 Elastic 和 OpenTelemetry 的更多信息，请参阅 OpenTelemetry 集成。