6.5 ahfscope Console Commands

Use the ahfscope -i command option to activate an interactive command-line interface (CLI). Enter a question mark (?) to see the list of available commands.

Syntax

cha> ?
	list item
     	entities
     	inputs
     	kinds
          	verbose
     	metrics
          	details
     	probes
                 diff
                 nounit
                 noobserved
                 nopredicted
                 missing
                 flagged
                 units
                 diagnose
        trace item
	     f: (feed)
	     d: (db)
	     i: (input)
	     p: (probes)
	     r: (rootcause)
	     t: (topology)
        version
        zoom (in|out)
        quit

Parameters

Table 6-1 ahfscope Console Command Parameters

Parameter Description

list item
  • entities: List of entities and time ranges of their relations.
  • inputs: Lists input feeds
  • kinds: Kinds of Entities and number of their metrics
    • verbose: Lists metrics with every kind
  • metrics: List of all known metrics and their units of measure.
    • details: Lists metrics with full name and description of value
  • probes: List of all probes (signals) for all entities.
    • diff: Lists probes where number of predicted and observed values differ
    • nounit: Lists probes without unit of measure
    • noobserved: Lists probes without observed values
    • nopredicted: Lists probes without predicted values
    • missing: Lists probes with missing values in some samples
    • flagged: Lists probes flags set
  • units: List units of measure.
    • diagnose: Shows conversion rules and values at conversion thresholds.

trace item
Switch tracing on/off, indicated by '+' or '-'.
  • f: (feed) Live feed activity.
  • d: (db) Toggle alter session for trace event 10046 (ORA DB).
  • i: (input) Copy incoming data to the log file.
  • p: (probes) Displays internal or descriptive probe names.
  • r: (rootcause) Prints to console CLOB's containing a root cause of a problem.
  • t: (topology) Displays changes in set of entities (topology).

version

Version of the (1) user interface, (2) data stream, and (3) Java Virtual Machine.

zoom (in|out)

Sets or resets magnify option.

quit

Exits AHF Scope GUI.
For convenience, AHF Scope's CLI provides an abbreviation grammar. For example: Instead of typing version, you can simply type v:
cha> version
   CHA UI version:     V1.00.000
   Data version:       V0.17
   PL/SQL package:     V0.10.11.2
   Java version:       1.8.0_77 on Linux
cha> v
   CHA UI version:     V1.00.000
   Data version:       V0.17
   PL/SQL package:     V0.10.11.2
   Java version:       1.8.0_77 on Linux

When more than one command starts with the same prefix, they need to be disambiguated. For example, debug versus device would require typing at least 3 letters to correctly identify the desired command. These commands provide summaries not available in graphical form.

Parent topic: Analyze Issue Root Cause