[AppInsights] Data Sources - API: Push Data to AppInsights widgets

Our custom data tools are designed to make it incredibly easy for users to connect unique data sources to their dashboards.  The Push Data tool is ideal for users that would like to export data from an on-premises server environment or other source that does not make data-sets available to AppInsights’s servers.  Using your unique account access key and individual widget stream names, you can populate any AppInsights visualization as long as the corresponding data point or data set is provided in our native format.

Prior to using this walkthrough, you may be interested in reviewing our full API documentation for more context on the technical capabilities of the Push Data tool.

To get started, navigate to the Services pane, select the API Data Widgets tile, and then the “Push Data” option.  You will be presented with a list of visualization options to choose from -- for this example, let’s use the basic Number widget.




Select your visualization and you'll notice that a new widget will appear on your dashboard.  Any time a new custom data widget is deployed to the dashboard, it will need to be configured.  To get started, hit the gear icon and navigate to the “Edit Widget Settings” menu.

From the “Data Settings” tab, confirm the stream name for your widget.  You may use the randomly generated stream name, or you can specify a name of your choice...but please note that you may not use the same stream name for multiple widgets.  If you deploy a new custom data widget to the dashboard and do not first confirm the stream name from the “Edit Widget Settings” menu, you will be unable to populate your widget.

Using a basic curl command, send your “Access Key” -- consistent across all dashboards / widgets -- as well as your “Stream Name” -- unique to each widget -- and then structure the rest of your command line to cooperate with the visualization type you’ve chosen (detailed instructions in our API documentation).

Our sample curl command will surface the number of seconds since the Unix epoch...

curl -X POST \
    -d "{\"accessKey\": \"ziL2DDCUCGWuanTpPkBpg4WEMsrGZd0m\", \"streamName\": \"JxP2JrHB\", \"point\": {\"number\": "`date +%s`", \"suffix\":\" seconds\"} }"

A successful run of your command will immediately populate your corresponding AppInsights widget with the data you’ve generated…

This is one basic example of our Push Data tool in action -- we look forward to hearing from you with details on the unique uses you discover!

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request