docs/html/tools/help/am-sysinfo.jd

page.title=System Information
parent.title=Android Monitor
parent.link=android-monitor.html
meta.tags="android, performance, profiling, tools, monitor"
page.tags="android", "performance", "profiling", "tools", "monitor"
page.metaDescription=Use the System Information tool to capture <code>dumpsys</code> information about your app. View activity manager, package, memory usage, and graphics state information.
page.image=tools/help/thumbnails/am_sysinfo.png
page.article=true
@jd:body
<div id="qv-wrapper">
<div id="qv">
  <h2>In this document</h2>
<ol>
  <li><a href="#sysinfo">Examining System Information for a Running App</a></li>
  <li><a href="#viewsysinfo">Viewing Saved System Information</a></li>
  <li><a href="#sysinfo-files">Working with System Information Files</a></li>
</ol>

</div>
</div>

<p>
  You can capture <code>dumpsys</code> output from within Android Monitor and
  display the file in the Code Editor. The <em>Captures</em> window lists the
  system information files so you can retrieve the information later for
  analysis.
</p>



<h2 id="sysinfo">
  Examining System Information for a Running App
</h2>
<p>
  To capture and view a snapshot of system information:
</p>

<ol>
  <li>Meet the <a href=
  "{@docRoot}tools/help/am-basics.html#byb">prerequisites and dependencies</a>.
  </li>
 <li>Open an app project.
  </li>
  <li><a href=
  "{@docRoot}tools/building/building-studio.html#RunningApp">Run the app</a> on
  a hardware device or emulator.
  </li>
  <li>
    <a href="{@docRoot}tools/help/am-basics.html#displaying">Display Android Monitor</a>.
  </li>

  <li>In the toolbar of the Android Monitor main window, click System Information
    <img src="{@docRoot}images/tools/am-isysteminfo.png"
    style="vertical-align:sub;margin:0;height:17px" alt="System Information icon" />
    and then select a menu item.
  </li>

<p>
  The menu items display different types of <code><a href=
  "https://source.android.com/devices/tech/debug/dumpsys.html">dumpsys</a></code>
  output:
</p>

<ul>
  <li>
    <strong>Activity Manager State</strong> - <code>dumpsys activity</code>
  </li>

  <li>
    <strong>Package Information</strong> - <code>dumpsys package</code>
  </li>

  <li>
    <strong>Memory Usage</strong> - <code><a href=
    "{@docRoot}tools/debugging/debugging-memory.html#ViewingAllocations">dumpsys
    meminfo</a></code>
  </li>

  <li>
    <strong>Memory Use Over Time</strong> - <code><a href=
    "http://android-developers.blogspot.com/2014/01/process-stats-understanding-how-your.html">dumpsys
    procstats</a></code>
  </li>

  <li>
    <strong>Graphics State</strong> - <code><a href=
    "{@docRoot}training/testing/performance.html">dumpsys gfxinfo</a></code>
  </li>
</ul>

<p>
  The information appears in an editable text file in the Code Editor.
</p>
<img src="{@docRoot}images/tools/am-sysinfo.png" alt="System Information" />
<p>Android Studio creates the system information file with the
  filename <code><em>package_yyyy.mm.dd_hh.mm.ss</em>.txt</code> using the
  activity package (or project) name, year, month, day,
  hour, minute, and second of the capture, for example,
  <code>com.android.calc_2015.11.17_14.58.48.txt</code>.</p>
</ol>

<h2 id="viewsysinfo">
Viewing Saved System Information
</h2>

<p>
After you take a snapshot of system information, Android Studio automatically
stores it so you can view it again.</p>

<p>To examine a saved system information file:</p>

<ol>
          <li>Click
          <img src="{@docRoot}images/tools/am-icaptures.png"
          style="vertical-align:sub;margin:0;height:17px"
          alt="Captures icon" /> in the main window.
          </li>
          <p>Or select <strong>View</strong> > <strong>Tools Windows</strong> >
          <strong>Captures</strong>.</p>

        <p>
          The <em>Captures</em> window appears.
        </p>

      <li>Open the <strong>System Information</strong> folder.
      </li>

      <li>Double-click the file to view it.
      </li>
</ol>


<h2 id="sysinfo-files">Working with System Information Files</h2>
<p>You can rename, locate, and delete a system information file from within
Android Studio.</p>

<h3 id="renamesysinfo">
  Renaming a system information file
</h3>

<p>
  Rename a system information file from within Android Studio so it
  continues to appear in the <em>Captures</em> window.</p>

  <p>To rename a system information file:
</p>

<ol>
  <li>In the <em>Captures</em> window, right-click the file and select
  <strong>Rename</strong>.
  </li>

  <li>In the dialog, specify the name of the file and click <strong>OK</strong>.
  </li>
</ol>

<h3 id="locatesysinfo">
  Locating a system information file on disk
</h3>

<p>
  You can quickly discover where Android Studio stored system information files
  on disk.</p>

  <p>To locate a system information file on disk:
</p>



<ul>
  <li>In the <em>Captures</em> window, right-click a system information file and
  select <strong>Show</strong> or <strong>Reveal</strong>.
  </li>

<p>
  Android Studio opens an operating system file browser displaying the location
  where the file resides.
</p>
</ul>
<p class="note">
  <strong>Note:</strong> If you move a system information file, Android Studio
  no longer displays the file
  in the <em>Captures</em> window. To display it, use <strong>File</strong> &gt;
  <strong>Open</strong>. Also, rename a file from the <em>Captures</em>
  window and not in the operating system file browser.
</p>

<h3 id="deletesysinfo">
  Deleting a system information file
</h3>

<p>
  To delete a system information file:
</p>

<ul>
  <li>In the <em>Captures</em> window, right-click a system information file
  and select <strong>Delete</strong>.
  </li>
</ul>

<p>
  Android Studio deletes the file from the <em>Captures</em> dialog and from
  disk.
</p>