Add An Infra

This assumes you have already created your Grafana instance.

This process is typically part of the Creating a New Infra Platform process.

You will need to log in to Grafana with an adminstrative user.

Create the organisation(s)

Name Purpose Comments

<Deployment> <Infra> Auto

Autogenerated dashboards from signal properties mqtt messsages

Required

<Deployment> <Infra> Custom

Generated dashboards from custom dashboard mqtt messages

Deprecated: new custom dashboards will probably be created differently, so I won’t document this further
Make a note of the OrgId. If it is not immediately visible, you can find it under Server Admin > Orgs.

Configure the Organisation

In Grafana, first switch to the Organisation if you are not already in it.

Create an API Key for the organisation(s)

  • Go to Configuration > API Keys > Add API Key

  • Name the key dashboard_generator and give it admin privileges

Make a note of the generated key; this is the api_key we need for the infra ansible configuration

Set the Datasource

  • Go to Configuration > Datasources > Add data source

  • Select InfluxDB

  • Set the following configuration:

Field Comments Value

Name

It helps if you include the infra name in this. You can even use the dbname if you want to be super clear

e.g. <deploy_level>_<infra>

HTTP.URL

The url for the influx instance. This can vary depending on the age of the infra. As long as it resolves to the correct server it will work.

e.g. http://influx.<hostname>.dgcsdev.com
(no port required if hitting an nginx-managed endpoint)

HTTP.Access

Leave this as-is

Server (Default)

InfluxDB Details.Database

The database name in Influx

Conventionally, <deploy_level>_<infra_id>