Azure Monitor integration with Kloudmate

5min
This document provides a comprehensive guide to integrating Azure Monitor with KloudMate using the OpenTelemetry Receiver. The Azure Monitor OpenTelemetry Receiver allows you to scrape telemetry data from Azure Monitor resources and send them to KloudMate for centralized monitoring and analysis.
Pre-requisite:
Azure Service Principal for Authentication: You will need a service principal with appropriate permissions to access Azure Monitor APIs.

Required settings for authentication:
subscription_id
tenant_id
client_id
client_secret
 To enable authentication follow the document: Enable Service Principal Azure. ﻿
Install the OpenTelemetry Collector on a server where it will scrape the Azure Monitor metrics and forward them to KloudMate.
Installing the OpenTelemetry Collector 
Step 1: Set Up the Azure Monitor Receiver in the OpenTelemetry Configuration File
Linux Users: Open the file located at /etc/otelcol-contrib/config.yaml using your preferred text editor.
Windows Users: Create a new file called config.yaml in the C:\Program Files\OpenTelemetry Collector folder. You can use Notepad or any text editor to do this.
1. In this configuration file, ensure the Azure Monitor receiver is set up to collect and send metrics.
YAML
extensions:
  health_check:
  pprof:
    endpoint: 0.0.0.0:1777
  zpages:
    endpoint: 0.0.0.0:55679

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318

  azuremonitor:
    # Add the correct credentials as per Service Principal
    subscription_id: "<subscription_id>"
    tenant_id: "<tenant_id>"
    client_id: "<client_id>"
    client_secret: "<client_secret>"
    cloud: AzureCloud
    collection_interval: 60s
    initial_delay: 1s
    # Uncomment and configure to monitor specific resource groups or services
    # resource_groups: []
    # services: []
extensions:
  health_check:
  pprof:
    endpoint: 0.0.0.0:1777
  zpages:
    endpoint: 0.0.0.0:55679

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
      http:
        endpoint: 0.0.0.0:4318

  azuremonitor:
    # Add the correct credentials as per Service Principal
    subscription_id: "<subscription_id>"
    tenant_id: "<tenant_id>"
    client_id: "<client_id>"
    client_secret: "<client_secret>"
    cloud: AzureCloud
    collection_interval: 60s
    initial_delay: 1s
    # Uncomment and configure to monitor specific resource groups or services
    # resource_groups: []
    # services: []
﻿
To monitor a specific service or resource group, the user can uncomment the resourcegroup[ ] and services[ ] entries in the configuration file.
2. Configure the processor section and the KloudMate Backend exporter in the OpenTelemetry configuration file, while defining the pipeline.
YAML
processors:
  batch:
    send_batch_size: 10000
    timeout: 30s

exporters:
  debug:
    verbosity: detailed

  otlphttp:
    endpoint: 'https://otel.kloudmate.com:4318'
    headers:
      Authorization: XXXXX  # Replace with your actual KloudMate authentication key
service:

  pipelines:
    metrics:
      receivers: [otlp, azuremonitor]
      processors: [batch]
      exporters: [debug, otlphttp]

  extensions: [health_check, pprof, zpages]
processors:
  batch:
    send_batch_size: 10000
    timeout: 30s

exporters:
  debug:
    verbosity: detailed

  otlphttp:
    endpoint: 'https://otel.kloudmate.com:4318'
    headers:
      Authorization: XXXXX  # Replace with your actual KloudMate authentication key
service:

  pipelines:
    metrics:
      receivers: [otlp, azuremonitor]
      processors: [batch]
      exporters: [debug, otlphttp]

  extensions: [health_check, pprof, zpages]
﻿
Step 2:  To restart and verify the status of the OpenTelemetry (Otel) Collector, follow these steps:
For Linux:
Execute the following commands:
Text
sudo systemctl restart otelcol-contrib
sudo systemctl status otelcol-contrib
sudo systemctl restart otelcol-contrib
sudo systemctl status otelcol-contrib
﻿
These commands will restart the Otel Collector and display its current status.
For Windows:
Open the Services window:
Press Win + R, type services.msc, and press OK.
Alternatively, search for "Services" in the Windows Start menu.
In the Services window, locate the "OpenTelemetry Collector" service.
Right-click the service and select "Restart."

After the OpenTelemetry Collector starts, it will scrape metrics from Azure Monitor and forward them to KloudMate.
Did this page help you?
Azure Monitoring
Enable Service Principal Azure