Analyzer

目录

介绍

分析器是用来分析各种程序问题的脚本工具。

每个分析器都有自己的用途。

你可以使用 orxray analyzer 子命令来获取分析器列表,搜索分析器,创建和运行分析器。

回到目录

用法

Usage: orxray analyzer command [OPTIONS]

COMMAND:
    create
    run
    list
    search

GLOBAL OPTIONS:
    --help
    --config                           specify config file, default is ~/.orxray/config.

回到目录

Create

回到目录

用法

这个命令创建一个新的分析器

Usage: orxray analyzer create <name> [OPTIONS]

OPTIONS:
    --desc                             Description.
    --ysql                             YSQL.
    --ylang                            Ylang.
    --ylua                             Ylua.
    --opslang                          Opslang.


GLOBAL OPTIONS:
    --help
    --config                           specify config file, default is ~/.orxray/config.

<name>

分析器的名称

--desc "description"

分析器的相关描述

--ysql 'YSQL code'

分析器脚本使用的 YSQL 代码

--ylang 'Ylang code'

分析器脚本使用的 Ylang 代码

--ylua 'ylua code'

分析器脚本使用的 Ylua 代码

--opslang 'opslang code'

分析器脚本使用的 Opslang 代码

回到目录

示例

使用 YSQL 代码来创建一个分析器,分析器可以打印进程的内存相关信息。

$ orxray analyzer create cli-test --ysql 'select res_mem from proc'
ID: 10075

回到目录

Run

运行一个你指定的分析器

回到目录

用法

Usage: orxray analyzer run tool [OPTIONS]

OPTIONS:
    -a, --agent integer                agent id, please use agent default command to set default agent.
    -p, --pid integer                  pid. If pid is negative, will auto find the pgid of the -pid.
    -c, --exe string                   command.
    -t integer                         sample time in seconds.
    --y-var                            ylang variable. Change the Ylang variable in runtime.

GLOBAL OPTIONS:
    --help
    --config                           specify config file, default is ~/.orxray/config.

回到目录

示例

下面的例子在默认的 agent 上运行 c-on-cpu 分析工具来对进程4502进行分析。

运行完后你可以去访问返回的 URI 网址来查看生成的火焰图。

$ orxray analyzer run c-on-cpu -p 4502
Goto https://your_id.xray.openresty.com/targets/27/history/8885766 for charts.

下面的例子在默认 agent 上运行 c-on-cpu 分析工具来对进程4502 所在的进程组进行分析。 注意这里面传递的是参数是 -4502。

$ orxray analyzer run c-on-cpu -p -4502
Goto https://your_id.xray.openresty.com/targets/27/history/8885767 for charts.

下面的例子分析进程 ID 为 4052 的进程,并传递参数 pcre_unwind=1。

$ orxray analyzer run lj-c-on-cpu -p 4502 --y-var pcre_unwind=1
Goto https://your_id.xray.openresty.com/targets/27/history/8885767 for charts.

回到目录

List

显示出所有的分析器信息。

回到目录

用法

Usage: orxray analyzer list

OPTIONS:
    -s, --page-size integer            page size, 10(default).

GLOBAL OPTIONS:
    --help
    --config                           specify config file, default is ~/.orxray/config.

-s, --page-size integer

指定返回数据项的最大数目

回到目录

示例

$ orxray analyzer list
ID      NAME                    DESCRIPTION
1       count-on-cpu-frames     count on cpu frames
2       count-off-cpu-frames    count off cpu frames
3       lj-c-on-cpu             C-land CPU Flame Graph
7       c-on-cpu                C-land CPU Flame Graph
8       c-off-cpu               C-land off-CPU Flame Graph
9       kernel-on-cpu           kernel-land on-CPU Flame Graph
11      resty-memory            Application-Level Memory Usage Breakdown
12      count-lj-newgco-frames  count LuaJIT new GC objects frames
14      glibc-chunks            Distributions of Memory Chunk Sizes in Glibc Allocator
15      lj-gco-stat             Statistics for LuaJIT GC Objects

回到目录

可以根据关键字来搜索分析器

回到目录

Usage: orxray tool search WORD [OPTIONS]

OPTIONS:
    -s, --page-size integer            page size, 10(default).

GLOBAL OPTIONS:
    --help
    --config                           specify config file, default is ~/.orxray/config.

-s, --page-size integer

指定返回搜索到的分析器的最大数目

回到目录

搜索关键字cpu相关的工具

$ orxray analyzer search cpu
count-on-cpu-frames
count-off-cpu-frames
lj-c-on-cpu
lj-lua-on-cpu
lj-c-off-cpu
lj-lua-off-cpu
c-on-cpu
c-off-cpu
kernel-on-cpu
count-lj-c-on-cpu

回到目录