</script><metaname="aes-config"content="pid=xux-opensource&user_type=101&uid=&username="><scriptsrc="//g.alicdn.com/alilog/mlog/aplus_v2.js"id="beacon-aplus"exparams="clog=o&aplus&sidx=aplusSidx&ckx=aplusCkx"></script><scriptsrc="//g.alicdn.com/aes/??tracker/1.0.34/index.js,tracker-plugin-pv/2.4.5/index.js,tracker-plugin-event/1.2.5/index.js,tracker-plugin-jserror/1.0.13/index.js,tracker-plugin-api/1.1.14/index.js,tracker-plugin-perf/1.1.8/index.js,tracker-plugin-eventTiming/1.0.4/index.js"></script><title>options | arthas</title><metaname="description"content="arthas user document">
<spanclass="token number">0</span> boolea unsafe <spanclass="token boolean">false</span> Option to support sy This option enables to proxy functionality
n stem-level class of JVM classes. Due to serious security r
isk a JVM crash is possibly be introduced.
Do not activate it unless you are able to
manage.
<spanclass="token number">1</span> boolea dump <spanclass="token boolean">false</span> Option to dump the e This option enables the enhanced classes t
n nhanced classes o be dumped to external <spanclass="token function">file</span><spanclass="token keyword">for</span> further d
e-compilation and analysis.
<spanclass="token number">1</span> boolea batch-re-tra <spanclass="token boolean">true</span> Option to support ba This options enables to reTransform classe
n nsform tch reTransform Clas s with batch mode.
s
<spanclass="token number">2</span> boolea json-format <spanclass="token boolean">false</span> Option to support JS This option enables to <spanclass="token function">format</span> object outpu
n ON <spanclass="token function">format</span> of object t with JSON when -x option selected.
output
<spanclass="token number">1</span> boolea disable-sub- <spanclass="token boolean">false</span> Option to control <spanclass="token keyword">in</span> This option disable to include sub class w
n class clude sub class when hen matching class.
class matching
<spanclass="token number">1</span> boolea support-defa <spanclass="token boolean">true</span> Option to control <spanclass="token keyword">in</span> This option disable to include default met
n ult-method clude default method hod <spanclass="token keyword">in</span> interface when matching class.
<spanclass="token keyword">in</span> interface when c
lass matching
<spanclass="token number">1</span> boolea save-result <spanclass="token boolean">false</span> Option to print <spanclass="token function">comm</span> This option enables to save each <spanclass="token builtin class-name">command</span><spanclass="token string">'s
n and'</span>s result to log result to log file, <spanclass="token function">which</span> path is <spanclass="token variable">${user.
file home}</span>/logs/arthas-cache/result.log.
<spanclass="token number">2</span> String job-timeout 1d Option to job timeou This option setting job timeout,The unit c
t an be d, h, m, s <spanclass="token keyword">for</span> day, hour, minute, se
cond. 1d is one day <spanclass="token keyword">in</span> default
<spanclass="token number">1</span> boolea print-parent <spanclass="token boolean">true</span> Option to print all This option enables print files <spanclass="token keyword">in</span> parent
n -fields fileds <spanclass="token keyword">in</span> parent cla class, default value true.
ss
<spanclass="token number">1</span> boolea verbose <spanclass="token boolean">false</span> Option to print verb This option enables print verbose informat
n ose information ion, default value false.
<spanclass="token number">1</span> boolea strict <spanclass="token boolean">true</span> Option to strict mod By default, strict mode is true, not allow
n e ed to <spanclass="token builtin class-name">set</span> object properties. Want to <spanclass="token builtin class-name">set</span> o
</code></pre><divclass="line-numbers"aria-hidden="true"><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div></div></div><h2id="get-special-option-value"tabindex="-1"><aclass="header-anchor"href="#get-special-option-value"aria-hidden="true">#</a> Get special option value</h2><divclass="language-text ext-text line-numbers-mode"><preclass="language-text"><code>$ options json-format
</code></pre><divclass="line-numbers"aria-hidden="true"><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div></div></div><divclass="custom-container tip"><pclass="custom-container-title">TIP</p><p>By default, <code>json-format</code> is false. When set <code>json-format</code> to true, commands like <code>wathc</code>/<code>tt</code> will print result with <code>json</code> format.</p></div><h2id="set-special-option-value"tabindex="-1"><aclass="header-anchor"href="#set-special-option-value"aria-hidden="true">#</a> Set special option value</h2><p>For example, to enable saving command execution result, input the command below:</p><divclass="language-text ext-text line-numbers-mode"><preclass="language-text"><code>$ options save-result true
</code></pre><divclass="line-numbers"aria-hidden="true"><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div></div></div><h2id="set-unsafe-to-true-to-enhance-the-classes-under-the-java-package"tabindex="-1"><aclass="header-anchor"href="#set-unsafe-to-true-to-enhance-the-classes-under-the-java-package"aria-hidden="true">#</a> Set <code>unsafe</code> to true to enhance the classes under the <code>java.*</code> package</h2><p>By default, <code>watch</code>/<code>trace</code>/<code>tt</code>/<code>trace</code>/<code>monitor</code> command do not support classes under <code>java.*</code> package. You can set <code>unsafe</code> to true to enhance the classes under the <code>java.*</code> package.</p><divclass="language-bash ext-sh line-numbers-mode"><preclass="language-bash"><code>$ options unsafe <spanclass="token boolean">true</span>
</code></pre><divclass="line-numbers"aria-hidden="true"><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div></div></div><h2id="turn-off-strict-mode-allow-setting-object-properties-in-ognl-expressions"tabindex="-1"><aclass="header-anchor"href="#turn-off-strict-mode-allow-setting-object-properties-in-ognl-expressions"aria-hidden="true">#</a> Turn off strict mode, allow setting object properties in ognl expressions</h2><divclass="custom-container tip"><pclass="custom-container-title">TIP</p><p>since 3.6.0</p></div><p>For new users, there may be misuses when writing ognl expressions.</p><p>For example, for <code>Student</code>, when judging the age is equal to 18, the conditional expression may be mistakenly written as <code>target.age=18</code>, which actually sets the <code>age</code> of the current object to 18. The correct spelling is <code>target.age==18</code>.</p><p>In order to prevent misuse like the above, Arthas enables <code>strict</code> mode by default, in <code>ognl</code> expressions, it is forbidden to update the property of the object or call the <code>setter</code> method.</p><p>Take <code>MathGame</code> as an example, the following error message will appear.</p><divclass="language-text ext-text line-numbers-mode"><preclass="language-text"><code>$ watch demo.MathGame primeFactors 'target''target.illegalArgumentCount=1'
watch failed, condition is: target.illegalArgumentCount=1, express is: target, By default, strict mode is true, not allowed to set object properties. Want to set object properties, execute `options strict false`, visit /Users/admin/logs/arthas/arthas.log for more details.
</code></pre><divclass="line-numbers"aria-hidden="true"><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div><divclass="line-number"></div></div></div><p>If the user want to change the object properties in the <code>ognl</code> expression, you can execute <code>options strict false</code> to turn off the <code>strict</code> mode.</p><ul><li>For more information, please refer to: https://github.com/alibaba/arthas/issues/2128</li></ul></div><!--[--><!--]--></div><footerclass="page-meta right-menu-padding"data-v-8e2a76de><divclass="meta-item edit-link"><aclass="external-link meta-item-label"href="https://github.com/alibaba/arthas/edit/master/site/docs/en/doc/options.md"rel="noopener noreferrer"target="_blank"aria-label="Edit this page on GitHub"><!--[--><!--]--><span>Edit this page on GitHub</span><span><svgclass="external-link-icon"xmlns="http://www.w3.org/2000/svg"aria-hidden="true"focusable="false"x="0px"y="0px"viewbox="0 0 100 100"width="15"height="15"><pathfill="currentColor"d="M18.8,85.1h56l0,0c2.2,0,4-1.8,4-4v-32h-8v28h-48v-48h28v-8h-32l0,0c-2.2,0-4,1.8-4,4v56C14.8,83.3,16.6,85.1,18.8,85.1z"></path><polygonfill="currentColor"points="45.7,48.7 51.3,54.3 77.2,28.5 77.2,37.2 85.2,37.2 85.2,14.9 62.8,14.9 62.8,22.9 71.5,22.9"></polygon></svg><spanclass="external-link-icon-sr-only">open in new window</span></span><!--[--><!--]--></a></div><divclass="meta-item last-updated"><spanclass="meta-item-label">Last Updated: </span><!----></div><divclass="meta-item contributors"><spanclass="meta-item-label">Contributors: </span><spanclass="meta-item-info"><!--[--><!--[--><spanclass="contributor"title="email: hengyunabc@gmail.com">hengyunabc</span><!--[-->, <!--]--><!--]--><!--[--><spanclass="contributor"title="email: LHearen@126.com">Hearen</span><!--[-->, <!--]--><!--]--><!--[--><spanclass="contributor"title="email: 43456743+alfredzouang@users.noreply.github.com">alfredzouang</span><!--[-->, <!--]--><!--]--><!--[--><spanclass="contributor"title="email: i@fatpandac.com">Fatpandac</span><!--[-->, <!--]--><!--]--><!--[--><spanclass="contributor"title="email: hollowman186@vip.qq.com">Hollow Man</span><!--[-->, <!--]--><!--]--><!--[--><spanclass="contributor"title="email: ian.luo@gmail.com">beiwei30</span><!----><!--]--><!--]--></span></div></footer><navclass="page-nav right-menu-padding"data-v-8e2a76de><pclass="inner"><spanclass="prev"><ahref="/en/doc/auth.html"class=""aria-label="auth"><!--[--><!--]--> auth <!--[--><!--]--></a></span><spanclass="next"><ahref="/en/doc/base64.html"class=""aria-label="base64"><!--[--><!--]--> base64 <!--[--><!--]--></a></span></p></nav><!--[--><!--]--></main><!--]--></div><!----><!--]--></div>
