Getting Started with Intel® Energy Profiler (2018 Beta)

Use Intel® Energy Profiler to visualize power and energy consumption and identify system behaviors that waste energy on an Android*, Windows*, or Linux* OS system running on Intel architecture. Data collection is done using the Intel SoC Watch collector, followed by importing the results to Intel VTune™ Amplifier for viewing in correlated timelines.

Intel Energy Profiler is available within the Intel® System Studio.

Step 1: Configure and Install Intel SoC Watch on Target System

For detailed instructions on configuring your environment, see the Installation section of the Intel SoC Watch Release Notes for your target system's operating system. The latest Intel SoC Watch documents are available online at the Intel Developer Zone site. You can also find a copy on the host system in the targets directory after installing Intel System Studio or on the target system in the product's documentation directory after extracting the Intel SoC Watch package.

Step 2: Collect Data

Run the Intel SoC Watch command line tool on the target system, specifying the metrics to collect and length of time to run. Data collection can occur on an idle system or run concurrently with a workload that is started at any time before or during the collection. You must have administrative/root privileges when you run the command.

The command line options must include -m to collect trace data and -r vtune (Android or Linux) or -r sww (Windows) to generate an output file that can be imported into Intel VTune Amplifier.

For example, to run a collection for 1 minute (-t 60), gather data about how much time the CPU spends in low power states (-f cpu-cstate), include trace data (-m), create a result that can be imported into VTune Amplifier (-r vtune/sww), and store the reports in a specified directory location with the specified file name (-o results/test), you would use:

On Android or Linux:

socwatch -t 60 -f cpu-cstate -m -r vtune -o results/test

On Windows:

socwatch -t 60 -f cpu-cstate -m -r sww -o results/test

For detailed descriptions of each feature and feature group, see the Intel SoC Watch User's Guide for your target system's operating system.

Tip

  • Use feature group names as a shorthand for specifying several features (metrics) that should be collected at the same time. For instance, -f sys collects the most commonly used metrics, including low power state residency for CPU, GPU, and devices, CPU temperature and frequency, and memory bandwidth.

  • Use the --help option to discover all of the available metrics that can be collected on the system (found under feature and feature group names) as well as other options for controlling data collection and reporting.

Step 3: Import Result into Intel VTune Amplifier

  1. Copy the result file to the host system where VTune Amplifier is installed. The import files have either a *.pwr (Android or Linux) or *.sww1 (Windows) extension. For example, the files from the example in Step 2 would be results/test.pwr or results/test.sww1.

  2. Launch VTune Amplifier on the host system.

  3. Open or create a project.

  4. Click the Import Result button on the toolbar and browse to the result file that you copied from the target system.

    When the import completes, the Platform Power Analysis viewpoint opens automatically.

The cpu-cstate feature collected in Step 2 results in several C-State Residency and Wakeups reports as shown in the example report. The data appears in both a grid format and timeline. Hover over the timeline to get details for a specific time during the collection.

For more information, see the VTune Amplifier help.

Documentation and Resources

Document

Description

Getting Started with Intel SoC Watch

Getting Started with Intel SoC Watch provides a high-level overview for getting up and running with Intel SoC Watch.

Intel SoC Watch User's Guide: Android and Linux | Windows

The Intel SoC Watch User's Guide is a reference manual with explanations of all command line options and features as well as example reports.

The guide is available in the product's documentation directory after installation. A copy is also available from the Intel Developer Zone website.

Intel SoC Watch Release Notes: Android | Linux | Windows

The Intel SoC Watch Release Notes contain the most up-to-date information about the product, including a product description, technical support, and known limitations and issues for a particular operating system. This document also contains system requirements for installing the product.

The guide is available in the product's documentation directory after installation. A copy is also available from the Intel Developer Zone website.

Intel SoC Watch Online Help

The Intel SoC Watch help provides basic information about running a collection. It also includes information about how to view and analyze the results in the Intel VTune Amplifier graphical user interface.

Getting Started with Intel VTune Amplifier

Getting Started with Intel VTune Amplifier provides a high-level overview for configuring your first project and running a performance analysis collection.

Intel VTune Amplifier Help

The help is the primary documentation for the VTune Amplifier.

Intel VTune Amplifier Release Notes

The Release Notes document contains the most up-to-date information about the product, including a product description, technical support, and known limitations and issues.

This document also contains system requirements for installing the product. Before installation, the Release Notes document is located at the root level (same level as the installation script/executable) of the installation download package.

Intel Energy Profiler website

See this page for product support and related documentation.

Legal Information

Intel, Intel VTune Amplifier, and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.

*Other names and brands may be claimed as the property of others.

Microsoft, Windows, and the Windows logo are trademarks, or registered trademarks of Microsoft Corporation in the United States and/or other countries.

© Intel Corporation

Para obter informações mais completas sobre otimizações do compilador, consulte nosso aviso de otimização.