Apache SkyWalking Java Agent 使用教程
目录结构及介绍
Apache SkyWalking Java Agent 的目录结构如下:
skywalking-java/
├── apm-agent/
│ ├── optional-plugins/
│ ├── plugins/
│ ├── skywalking-agent.jar
│ └── ...
├── apm-sdk-plugin/
│ ├── ...
├── docker/
│ ├── ...
├── ...
apm-agent/
: 包含 SkyWalking Java Agent 的核心文件,如skywalking-agent.jar
和各种插件。optional-plugins/
: 可选插件,需要手动激活。plugins/
: 默认激活的插件。
apm-sdk-plugin/
: 包含 SDK 插件。docker/
: 包含 Docker 相关的配置和脚本。
项目的启动文件介绍
SkyWalking Java Agent 的启动文件主要是 skywalking-agent.jar
。在使用时,需要将其添加到 Java 应用的启动参数中。
例如,在 Linux 系统中启动 Tomcat 时,可以修改 tomcat/bin/catalina.sh
文件,添加以下内容:
CATALINA_OPTS="$CATALINA_OPTS -javaagent:/path/to/skywalking-agent/skywalking-agent.jar"
export CATALINA_OPTS
在 Windows 系统中,可以修改 tomcat/bin/catalina.bat
文件,添加以下内容:
set "CATALINA_OPTS=-javaagent:/path/to/skywalking-agent/skywalking-agent.jar"
项目的配置文件介绍
SkyWalking Java Agent 的配置文件通常位于 skywalking-agent.jar
所在的目录中,名为 agent.config
。该文件包含各种配置项,如服务名称、日志级别、采样率等。
以下是一些常见的配置项:
agent.service_name=${SW_AGENT_NAME:Your_Application_Name}
agent.sample_n_per_3_secs=${SW_AGENT_SAMPLE:1}
logging.level=${SW_LOGGING_LEVEL:INFO}
agent.service_name
: 定义应用的服务名称。agent.sample_n_per_3_secs
: 定义采样率。logging.level
: 定义日志级别。
通过修改 agent.config
文件,可以调整 SkyWalking Java Agent 的行为和性能。
以上是 Apache SkyWalking Java Agent 的基本使用教程,涵盖了项目的目录结构、启动文件和配置文件的介绍。希望对您有所帮助。