Azure Monitor Integration¶

Introduction¶

You can export metrics and operation logs of your Hasura Cloud project to Azure Monitor. This can be configured on the integrations tab on the project’s setting page.

Prerequisites¶

• Create a Service Principal in Azure.

• From the Overview tab of the created Service principal , retrieve Application (client) ID (Referred as Active Directory Client ID in this context) and Directory (tenant) ID (Referred as Active Directory Tenant ID in this context)

  

• From the Certificates & secrets tab of the created service principal, Create a client secret by clicking New client secret. Add a suitable description and expiry period for the secret and click Add. Copy the value of the created secret (Referred as Active Directory Client Secret in this context)

  

• Create a Log Analytics Workspace in Azure.

• From the Agents management tab of the created log analytics workspace, retrieve Workspace ID and Primary Key (Referred as Shared Key in this context).

  

• From the Properties tab of the created log analytics workspace, retrieve Resource ID and Location (Referred as Region in this context)

  

• Assign the Role Monitoring Metrics Publisher to the Service principal against the Log analytics workspace. From the Access control (IAM) tab of the created log analytics workspace, Click on Add and select Add role assignment. In the Add role assignment panel, Select the Role as Monitoring Metrics Publisher and select the created service principal for role assignment and click Save.

  

Configure Azure Monitor integration¶

Navigate to the integrations tab on project settings page to find Azure Monitor integration.

Enter the values of config parameters obtained from the steps in pre-requisites in the Azure monitor integration form. In addition to the above parameters, the following fields are also needed:

After adding appropriate values in the Azure monitor Integration panel, click Save.

Checking the status of the integration¶

The green/red dot signifies the status of the integration. Green signifies successful exporting of logs to Azure monitor. When logs are successfully exported, Last Exported is continuously updated, indicating the timestamp of the last log line successfully exported to your Azure monitor dashboard.

In case there is an error while exporting logs to Azure monitor, the dot is red and the HTTP status code of the error and the message is displayed right below it.

View metrics¶

The integration exports the following five metrics to Azure monitor:

Non zero values of all the above metrics are exported over a one minute time interval.

To navigate to Azure monitor metrics dashboard ,click View Metrics.

From the Select a scope panel, expand the resource group which contains the Log analytics workspace and select it and click Apply.In the filter menu, select the correct namespace and Add filter to view the individual metric.

View logs¶

To navigate to Azure monitor logs dashboard , click View Logs.

From the Select a scope panel, expand the resource group which contains the Log analytics workspace and select it and click Apply. The logs can be filtered using Log type. Use {YOUR_LOG_TYPE}_CL search parameter to filter the logs. Custom log types are displayed in the left of the Query panel.