update doc

This commit is contained in:
hengyunabc committed 2020-09-22 14:13:20 +08:00
1 parent 5ccb3e21a4
commit c1dcc8ff9e
12 files changed
+397 -4

No files matched your search

+53
View File
@@ -1,6 +1,59 @@
Docker
===
## 在Docker里使用JDK
很多时候,应用在docker里出现arthas无法工作的问题,是因为应用没有安装 JDK ,而是安装了 JRE 。如果只安装了 JRE,则会缺少很多JAVA的命令行工具和类库,Arthas也没办法正常工作。下面介绍两种常见的在Docker里使用JDK的方式。
### 使用公开的JDK镜像
* https://hub.docker.com/_/openjdk/
比如:
```
FROM openjdk:8-jdk
```
或者:
```
FROM openjdk:8-jdk-alpine
```
### 通过包管理软件来安装
比如:
```bash
# Install OpenJDK-8
RUN apt-get update && \
apt-get install -y openjdk-8-jdk && \
apt-get install -y ant && \
apt-get clean;
# Fix certificate issues
RUN apt-get update && \
apt-get install ca-certificates-java && \
apt-get clean && \
update-ca-certificates -f;
# Setup JAVA_HOME -- useful for docker commandline
ENV JAVA_HOME /usr/lib/jvm/java-8-openjdk-amd64/
RUN export JAVA_HOME
```
或者:
```bash
RUN yum install -y \
java-1.8.0-openjdk \
java-1.8.0-openjdk-devel
ENV JAVA_HOME /usr/lib/jvm/java-1.8.0-openjdk/
RUN export JAVA_HOME
```
## 通过Docker快速入门
1. 删除本地已有的`arthas-demo` docker container(非必要)
+46
View File
@@ -183,3 +183,49 @@ $ profiler version
Async-profiler 1.6 built on Sep 9 2019
Copyright 2019 Andrei Pangin
```
### 配置 framebuf 参数
> 如果遇到生成的svg图片有 `[frame_buffer_overflow]`,则需要增大 framebuf(默认值是 1'000'000),可以显式配置,比如:
```bash
profiler start --framebuf 5000000
```
### 配置 include/exclude 来过滤数据
如果应用比较复杂,生成的内容很多,想只关注部分数据,可以通过 include/exclude 来过滤。比如
```bash
profiler start --include 'java/*' --include 'demo/*' --exclude '*Unsafe.park*'
```
> include/exclude 都支持设置多个值 ,但是需要配置在命令行的最后。
### 指定执行时间
比如,希望profiler执行 300 秒自动结束,可以用 `-d`/`--duration` 参数指定:
```bash
profiler start --duration 300
```
### 生成 jfr格式结果
> 注意,jfr只支持在 `start`时配置。如果是在`stop`时指定,则不会生效。
```
profiler start --file /tmp/test.jfr
```
`file`参数支持一些变量:
* 时间戳: `--file /tmp/test-%t.jfr`
* 进程ID: `--file /tmp/test-%p.jfr`
生成的结果可以用支持jfr格式的工具来查看。比如:
* JDK Mission Control : https://github.com/openjdk/jmc
* JProfiler : https://github.com/alibaba/arthas/issues/1416
+2
View File
@@ -18,6 +18,8 @@ Arthas Spring Boot Starter
应用启动后,spring会启动arthas,并且attach自身进程。
> 一键创建包含 Arthas Spring Boot Starter 的工程:[点击](http://start.aliyun.com/bootstrap.html/#!dependencies=arthas)
### 配置属性
比如,通过配置tunnel server实现远程管理: