Skip to end of metadata
Go to start of metadata

You can send metrics to the Standalone Machine Agent using its HTTP listener. You can report metrics through the Standalone Machine Agent by making HTTP calls to the agent instead of piping to the agent through sysout.

To activate the HTTP listener

  • Restart the Standalone Machine Agent using metric.http.listener:

    java -Dmetric.http.listener=true -Dmetric.http.listener.port=<port_number> -jar machineagent.jar

If you do not specify the optional metric.http.listener.port, it defaults to 8293.

To send metrics

GET | POST /machineagent/metrics

To send events

GET /machineagent/event

To upload metrics

You can use GET or POST to upload metrics to the Metric Browser under Application Performance -> <Tier> where the tier is the one defined for the Standalone Machine Agent. For example:

http://host:port/machineagent/metrics?name=Custom Metrics|Test|My Metric&value=42&type=average

Valid values for type are:

  • average: Average of all one-minute data points when adding it to the 10-minute or 60-minute granularity table.
  • sum: Sum of all one-minute data points when adding it to the 10-minute or 60-minute granularity table.
  • current: Last reported one-minute data point in that 10-minute or 60-minute interval.

To upload events

Send events using HTTP get requests to:

http://localhost:8293/machineagent/event?type=<event_type>&summary=<summary_text>

Event_type is one of the following:

  • error
  • info
  • summary
  • warning

To shut down the standalone machine agent

GET /machineagent/shutdown