Help & DocumentationCreating Basic Metrics and Reports Basic MetricsAdd Data to a Metric Sourced from an External Process

Add Data to a Metric Sourced from an External Process

An External Process, when used as a Data Source for Metric Insights, generates a URL used to enter a Measurement Date and a Measurement Value. Any required authentication can also be automatically placed in URL.

Use case is for an External Process that may be doing Data Collection. This can be used for real-time aggregates or some other complementary data processing tool that is crunching data and wants to put results in Metric Insights for charting.

We typically counsel customers to land the data somewhere and allow us to pull it so that they have a more robust coupling between data reporting and Metric collection. The  reasons we don't generally recommend using External Processes as Data Sources are as follows:

  1. If something starts POSTing a huge amount of data to Metric Insights every second or so, serious problems could occur
  2. If Metric Insights happens to be unavailable when the data is posted, the data is lost

1. Open a Metric sourced from External Process

  1. Open the Data Collection tab
  2. Copy the Data Posting URL contents

1.1. If the Metric requires external process authentication

The Authentication field is displayed

and the URL contains two additional parameters:

  1. user (username) - highlighted blue above
  2. pass (password) - highlighted yellow above

NOTE: The values default to the settings of the Authentication parameter set selected; no additional data entry is required

2. Enter Data using URL

1. Open a new browser and paste in the URL

  • In the address space,  paste the URL copied from the Metric's Data Posting URL setting
  • Enter the Measurement Time in the format:  yyyy-mm-dd in place of <measurement_time>
  • Enter the Measurement Value in place of <value>
  • Press Enter

2.  Receive status message

Repeat the process to enter as many values as required; when finished, return to the Metric Editor.

2.1. When username/password are also required:

 

  1. Open a new browser tab; In the address space,  paste the URL copied from the Metric's Data Posting URL setting
  2. Note the the username/password are in the URL when pasted (highlighted blue and yellow above)
  3. Enter the Measurement Time in the format:  yyyy-mm-dd in place of measurement_time (highlighted turquoise above)
  4. Enter the Measurement Value in place of value and press Enter
  5. Receive status message (or error message)

NOTE:  Since the required username/password are already in the URL; no additional data entry is required.

Repeat the process to enter as many values as required; when finished, return to the Metric Editor.

3. Save & publish from Metric Editor to generate chart

After you Update Live Chart, the Metric Viewer opens:

  1. Hover over a data point entered to show the Data Point Mouse-over Display
  2. Confirm the date/value entered on the URL

0 Comments

Add your comment

E-Mail me when someone replies to this comment