20112014 Ericsson AB. All Rights Reserved. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. Observer observer_ug.xml
Introduction

Observer, is a graphical tool for observing the characteristics of erlang systems. Observer displays system information, application supervisor trees, process information, ets or mnesia tables and contains a frontend for erlang tracing.

General

Normally observer should be run from a standalone node to minimize the impact of the system being observed. Example:

> erl -sname observer -hidden -setcookie MyCookie -run observer

Choose which node to observe via Nodes menu. The View/Refresh Interval controls how frequent the view should be updated. The refresh interval is set per viewer so you can have different settings for each viewer. To minimize the system impact only the active viewer is updated and the other views will be updated when activated.

In general the mouse buttons behaves as expected, use left click to select objects, right click to pop up a menu with most used choices and double click to bring up information about the selected object. In most viewers with several columns you can change sort order by left clicking on column header.

Applications

The Applications view lists application information. Select an application in the left list to display its supervisor tree.

Trace process will add the selected process identifier to Trace Overview view and the node the process resides on will be added as well.

Trace named process will add the registered name of the process. This can be useful when tracing on several nodes, then processes with that name will be traced on all traced nodes.

Trace process tree and Trace named process tree will add the selected process and all processes below, right of, it to the Trace Overview view.

Processes

The Processes view lists process information. For each process the following information is presented:

Pid The process identifier. Reds This is the number of reductions that has been executed on the process Memory This is the size of the process in bytes, obtained by a call to process_info(Pid,memory). MsgQ This is the length of the message queue for the process.

Reds can be presented as accumulated values or as values since last update.

Process info open a detailed information window on the selected process. Process Information Shows the process information. Messages Shows the process messages. Dictionary Shows the process dictionary. Stack Trace Shows the process current stack trace. State Show the process state. Log If enabled and available, show the process SASL log entries.

Log needs SASL application to be started on the observed node, with log_mf_h as log handler. The Observed node must be R16B02 or higher. rb server must not be started on the observed node when clicking on menu 'Log/Toggle log view'. rb server will be stopped on the observed node when exiting or changing observed node.

Trace Processes will add the selected process identifiers to the Trace Overview view and the node the processes reside on will be added as well. Trace Named Processes will add the registered name of processes. This can be useful when tracing is done on several nodes, then processes with that name will be traced on all traced nodes.

Table Viewer

The Table Viewer view lists tables. By default ets tables are visible and unreadable, private ets, tables and tables created by the OTP applications are not visible. Use View menu to view "system" ets tables, unreadable ets tables or mnesia tables.

Double click to view the content of the table. Select table and activate View/Table Information menu to view table information.

In the table viewer you can regexp search for objects, edit and delete objects.

Trace Overview

The Trace Overview view handles tracing. Tracing is done by selecting which processes to be traced and how to trace them. You can trace messages, function calls and events, where events are process related events such as spawn, exit and several others.

When you want to trace function calls, you also need to setup trace patterns. Trace patterns selects the function calls that will be traced. The number of traced function calls can be further reduced with match specifications. Match specifications can also be used to trigger additional information in the trace messages.

Trace patterns only applies to the traced processes.

Processes are added from the Applications or Processes views. A special new identifier, meaning all processes spawned after trace start, can be added with the Add 'new' Process button.

When adding processes, a window with trace options will pop up. The chosen options will be set for the selected processes. Process options can be changed by right clicking on a process.

Processes added by process identifiers will add the nodes these processes resides on in the node list. Additional nodes can be added by the Add Nodes button.

If function calls are traced, trace patterns must be added by Add Trace Pattern button. Select a module, function(s) and a match specification. If no functions are selected, all functions in the module will be traced. A few basic match specifications are provided in the tool, and you can provide your own match specifications. The syntax of match specifications are described in the ERTS User's Guide. To simplify the writing of a match specification they can also be written as fun/1 see ms_transform manual page for further information.

Use the Start trace button to start the trace. By default trace output is written to a new window, tracing is stopped when the window is closed, or with Stop Trace button. Trace output can be changed via Options/Output menu. The trace settings, including match specifications, can be saved to, or loaded from, a file.

More information about tracing can be found in dbg and in the chapter "Match specifications in Erlang" in ERTS User's Guide and the ms_transform manual page.