Skip to main content

Counters

Overview​

The Counters tool provides a simple CLI interface for viewing Ember performance counters. For more information, refer to the Ember Monitoring Guide.

Sample Usage​

You can use the Counters tool to display specific counters that match a given wildcard pattern. Here's an example that displays all counters that have Order in their name:

$ /deltix/ember/bin/counters -filter *Order*

15:37:13 - Ember Stat
=========================
  1:           16,540,727 - Ember.TotalOrders
  3:                7,523 - Ember.ActiveOrders
 10:                   29 - Ember.UnknownOrderEvents
 12:               37,799 - Ember.OrdersPoolSize
 13:              219,567 - Ember.OrderEntriesPoolSize

The output shows the counter IDs, their corresponding values, and the counter names that match the provided wildcard pattern.

Command Line Arguments​

The Counters tool accepts the following command line arguments:

  • -filter <wildcard-pattern> - Use '*' as a wildcard symbol to specify the counters you want to display. This argument can be specified multiple times to apply to multiple filters.
  • -filter @<wildcard-filename> - Similar to the above option, but the wildcard patterns are read from a file. Each line in the file represents a separate filter.
  • -file <counters-file> - Specifies the location of the Ember counter file. If this argument is skipped, the tool uses the EMBER_WORK or EMBER_HOME environment variable to locate the counters file.

Example of running on host OS​

When ember is running under docker compose the following example can be used to run counters tool using ember container (you may need to adjust version number and path to EMBER_HOME and EMBER_WORK directories):

docker run --entrypoint "/opt/deltix/ember/bin/counters" -it -v "/home/r8fin/ember/config:/var/lib/emberhome" -v "/home/r8fin/ember/work:/var/lib/emberwork" "registry.deltixhub.com/deltix.docker/anvil/deltix-ember:1.14.149"