KloudMate

https://docs.kloudmate.com/
Admin
KloudMate is an end-to-end observability platform that gives your team unified visibility into logs,...
Tokens:92,443
Snippets:1,354
Trust Score:8
Update:3 months ago
Show doc for...
Tokens:
Raw
### Install OpenTelemetry Go SDK and Exporters

Source: https://docs.kloudmate.com/guides/opentelemetry/go

Installs the OpenTelemetry Go SDK, along with the stdouttrace and otlptracehttp exporters, using go get.

```bash
go get go.opentelemetry.io/otel/sdk \
       go.opentelemetry.io/otel/exporters/stdout/stdouttrace \
       go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp
```

--------------------------------

### Verify PostgreSQL Monitoring Setup

Source: https://docs.kloudmate.com/database-monitoring/direct-database-monitoring

These SQL queries, run as the `kloudmate` user, verify the installation of `pg_stat_statements`, Kloudmate functions, and check key configuration parameters like `track_activity_query_size` and `track_io_timing`.

```sql
-- Check pg_stat_statements is loaded
SELECT count(*) FROM pg_stat_statements;
```

```sql
-- Check functions exist
SELECT routine_name FROM information_schema.routines
 WHERE routine_schema = 'kloudmate';
```

```sql
-- Test pg_stat_activity wrapper
SELECT count(*) FROM kloudmate.pg_stat_activity();
```

```sql
-- Test explain
SELECT * FROM kloudmate.explain_statement('SELECT 1');
```

```sql
-- Check track_activity_query_size
SHOW track_activity_query_size;
```

```sql
-- Check track_io_timing
SHOW track_io_timing;
```

--------------------------------

### Example Express Application with Winston

Source: https://docs.kloudmate.com/guides/logs/send-winston-logs-with-opentelemetry-nodejs

An example Express application demonstrating basic Winston logging setup.

```typescript
import express from 'express'
import { createLogger, transports } from 'winston'

const logger = createLogger({
  transports: [new transports.Console()],
})

const app = express()
const port = 5000

app.get('/', (req: any, res: any) => {
  logger.info({ msg: 'received request', query: req.query })
  res.send('hello world')
})

app.listen(port, () => {
  logger.info(`Server is running at http://localhost:${port}`)
})
```

--------------------------------

### Install OpenTelemetry Go Packages

Source: https://docs.kloudmate.com/apm-and-tracing/manual-instrumentation/go

Installs the core OpenTelemetry Go packages and the OTLP HTTP exporter. Ensure you have Go installed and configured.

```bash
go get go.opentelemetry.io/otel \
  go.opentelemetry.io/otel/sdk \
  go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp
```

--------------------------------

### Install Flask

Source: https://docs.kloudmate.com/guides/opentelemetry/python

Installs the Flask framework using pip.

```bash
pip install flask
```

--------------------------------

### User Data Script for kmagent Installation

Source: https://docs.kloudmate.com/kloudmate-agent/installation/aws-asg-deployment

This bash script fetches the API key from SSM Parameter Store using IMDSv2, then downloads and installs the `kmagent`. It includes verification steps and logs errors if the agent fails to start.

```bash
#!/bin/bash
set -euo pipefail

# ----------------------------------------------- 
# Fetch API key from SSM (IMDSv2 compatible)
# ----------------------------------------------- 
REGION=$(curl -sf http://169.254.169.254/latest/meta-data/placement/region)
TOKEN=$(curl -sf -X PUT "http://169.254.169.254/latest/api/token" \
  -H "X-aws-ec2-metadata-token-ttl-seconds: 60")

KM_API_KEY=$(aws ssm get-parameter \
  --name "/kloudmate/api-key" \
  --with-decryption \
  --query "Parameter.Value" \
  --output text \
  --region "$REGION")

# ----------------------------------------------- 
# Install kmagent
# ----------------------------------------------- 
curl -fsSL https://raw.githubusercontent.com/kloudmate/km-agent/main/install.sh \
  | bash -s -- \
    --api-key "$KM_API_KEY" \
    --colector-endpoint "https://otel.kloudmate.com"

# ----------------------------------------------- 
# Verify
# ----------------------------------------------- 
if systemctl is-active --quiet kmagent; then
  echo "[kloudmate] Agent installed and running" 
else
  echo "[kloudmate] ERROR: Agent failed to start"
  journalctl -u kmagent --no-pager -n 20
  exit 1
fi
```

--------------------------------

### Install Django

Source: https://docs.kloudmate.com/guides/opentelemetry/python

Installs the Django framework using pip.

```bash
pip install django
```

--------------------------------

### Install OpenTelemetry .NET Packages

Source: https://docs.kloudmate.com/apm-and-tracing/manual-instrumentation/dotnet

Install the core OpenTelemetry .NET packages and the OTLP exporter via NuGet.

```bash
dotnet add package OpenTelemetry
dotnet add package OpenTelemetry.Exporter.OpenTelemetryProtocol
dotnet add package OpenTelemetry.Extensions.Hosting
```

--------------------------------

### Install Gems

Source: https://docs.kloudmate.com/apm-and-tracing/manual-instrumentation/ruby

Run bundle install to install the specified OpenTelemetry gems.

```bash
bundle install
```

--------------------------------

### Install OpenTelemetry Packages

Source: https://docs.kloudmate.com/guides/opentelemetry/python

Installs OpenTelemetry distribution, OTLP exporter, and bootstraps auto-instrumentation.

```bash
pip install opentelemetry-distro opentelemetry-exporter-otlp
opentelemetry-bootstrap -a install
```

--------------------------------

### Install Rails Gem

Source: https://docs.kloudmate.com/guides/opentelemetry/ruby

Use this command to install the Rails gem if you don't have it already.

```txt
gem install rails

```

--------------------------------

### Install traceloop-sdk and openai

Source: https://docs.kloudmate.com/llm-observability/instrument-with-openllmetry

Install the necessary Python packages for OpenLLMetry instrumentation and OpenAI API interaction.

```bash
pip install traceloop-sdk openai
```

--------------------------------

### Install OpenTelemetry for Slim Framework

Source: https://docs.kloudmate.com/guides/opentelemetry/php

Installs OpenTelemetry SDK, OTLP exporter, Guzzle adapter, and auto-instrumentation for Slim. Disables php-http/discovery plugin to avoid conflicts.

```bash
composer config allow-plugins.php-http/discovery false
composer require \
  open-telemetry/sdk \
  open-telemetry/exporter-otlp \
  php-http/guzzle7-adapter \
  open-telemetry/opentelemetry-auto-slim
```

--------------------------------

### Verify Monitoring Setup

Source: https://docs.kloudmate.com/database-monitoring/direct-database-monitoring

SQL queries to run as the monitoring user to verify that performance schema is enabled, consumers are active, and procedures exist.

```sql
-- Check performance_schema is enabled
SELECT @@performance_schema;

-- Check consumers are active
SELECT name, enabled FROM performance_schema.setup_consumers
 WHERE name LIKE 'events_statements_%' OR name = 'events_waits_current';

-- Check query digests are being collected
SELECT COUNT(*) FROM performance_schema.events_statements_summary_by_digest;

-- Verify procedures exist
SHOW PROCEDURE STATUS WHERE db = 'kloudmate';

-- Test explain
CALL kloudmate.explain_statement('SELECT 1');
```

--------------------------------

### Run Django Migrations and Server

Source: https://docs.kloudmate.com/guides/opentelemetry/python

Applies database migrations and starts the Django development server.

```bash
python manage.py migrate
python manage.py runserver 127.0.0.1:8000
```

--------------------------------

### Install OpenTelemetry Trace API Packages

Source: https://docs.kloudmate.com/guides/opentelemetry/go

Installs the necessary OpenTelemetry packages for Go trace instrumentation.

```bash
go get go.opentelemetry.io/otel \
       go.opentelemetry.io/otel/trace
```

--------------------------------

### Install gRPC Extension

Source: https://docs.kloudmate.com/guides/opentelemetry/php

Installs the gRPC extension, which may be required for certain OpenTelemetry configurations.

```bash
pecl install grpc
```

--------------------------------

### Install OpenTelemetry Packages

Source: https://docs.kloudmate.com/apm-and-tracing/manual-instrumentation/python

Install the necessary OpenTelemetry API, SDK, and exporter packages for Python using pip.

```bash
pip install opentelemetry-api \
  opentelemetry-sdk \
  opentelemetry-exporter-otlp
```

--------------------------------

### Run Slim Application

Source: https://docs.kloudmate.com/guides/opentelemetry/php

Start the Slim development server on localhost:8080. Verify by visiting http://localhost:8080/rolldice.

```bash
php -S localhost:8080
```

--------------------------------

### Install boto3 for AWS Dynamic Inventory

Source: https://docs.kloudmate.com/kloudmate-agent/installation/infrastructure-as-code-iaac-installation

Install the necessary Python library to use the AWS dynamic inventory plugin.

```bash
pip install boto3
```

--------------------------------

### Install Express and OpenTelemetry for JavaScript

Source: https://docs.kloudmate.com/guides/opentelemetry/node-js

Installs the Express framework and the Node.js auto-instrumentation package for JavaScript applications.

```bash
npm install express
npm install @opentelemetry/auto-instrumentations-node
```

--------------------------------

### Install google-auth for GCP Dynamic Inventory

Source: https://docs.kloudmate.com/kloudmate-agent/installation/infrastructure-as-code-iaac-installation

Install the required Python library for the GCP dynamic inventory plugin.

```bash
pip install google-auth
```

--------------------------------

### Install Azure Libraries for Azure Dynamic Inventory

Source: https://docs.kloudmate.com/kloudmate-agent/installation/infrastructure-as-code-iaac-installation

Install the necessary Python libraries for the Azure dynamic inventory plugin.

```bash
pip install azure-identity azure-mgmt-compute
```

--------------------------------

### Install OpenTelemetry Packages for Web

Source: https://docs.kloudmate.com/apm-and-tracing/manual-instrumentation/react

Install the required OpenTelemetry packages for web applications using npm.

```bash
npm install @opentelemetry/api \
  @opentelemetry/core \
  @opentelemetry/sdk-trace-web \
  @opentelemetry/exporter-trace-otlp-http \
  @opentelemetry/context-zone \
  @opentelemetry/instrumentation \
  @opentelemetry/instrumentation-document-load \
  @opentelemetry/instrumentation-user-interaction
```

--------------------------------

### Verify Docker Agent Installation

Source: https://docs.kloudmate.com/kloudmate-agent/installation/docker-agent

Run this command to check if the Docker agent is running correctly after installation. Ensure you have copied your account-specific command from KloudMate.

```bash
docker ps -a | grep kloudmate-agent
```

--------------------------------

### Install OpenTelemetry PHP Extension (Linux)

Source: https://docs.kloudmate.com/guides/opentelemetry/php

Installs the OpenTelemetry PHP extension on Ubuntu/Debian systems. Requires php-dev and php-pear.

```bash
sudo apt-get install php-dev php-pear
sudo pecl install opentelemetry
```

--------------------------------

### Install Cert Manager using Helm

Source: https://docs.kloudmate.com/kloudmate-agent/installation/kubernetes-agent

Install Cert Manager if it's not already present in your cluster. Ensure you meet the version prerequisites.

```bash
helm install \
  cert-manager oci://quay.io/jetstack/charts/cert-manager \
  --namespace cert-manager \
  --create-namespace \
  --set crds.enabled=true
```

--------------------------------

### Run Flask Application

Source: https://docs.kloudmate.com/guides/opentelemetry/python

Starts the Flask development server on port 8080.

```bash
flask run -p 8080
```

--------------------------------

### Install OpenTelemetry Packages for Node.js

Source: https://docs.kloudmate.com/apm-and-tracing/manual-instrumentation/node-js

Install the necessary OpenTelemetry packages for Node.js using npm. This includes the API, SDK, auto-instrumentations, and an OTLP HTTP trace exporter.

```bash
npm install @opentelemetry/api \
  @opentelemetry/sdk-node \
  @opentelemetry/auto-instrumentations-node \
  @opentelemetry/exporter-trace-otlp-http
```

--------------------------------

### Navigate to Ansible Directory

Source: https://docs.kloudmate.com/kloudmate-agent/installation/infrastructure-as-code-iaac-installation

Change the current directory to the Ansible installation folder.

```bash
cd ansible/
```

--------------------------------

### Install Kloudmate Functions in All Databases

Source: https://docs.kloudmate.com/database-monitoring/direct-database-monitoring

This script iterates through all non-template PostgreSQL databases and applies the `kloudmate_functions.sql` script to each. Ensure `kloudmate_functions.sql` is in your current directory.

```bash
for db in $(psql -t -c "SELECT datname FROM pg_database WHERE datistemplate = false"); do
  psql -d "$db" -f kloudmate_functions.sql
done
```

--------------------------------

### Main Application Entry Point

Source: https://docs.kloudmate.com/guides/opentelemetry/go

Sets up the main application entry point, handling signals and running the application.

```go
package main

import (
 "context"
 "log"
 "os"
 "os/signal"
)

func main() {
 l := log.New(os.Stdout, "", 0)

 sigCh := make(chan os.Signal, 1)
 signal.Notify(sigCh, os.Interrupt)

 errCh := make(chan error)
 app := NewApp(os.Stdin, l)
 go func() {
  errCh <- app.Run(context.Background())
 }()

 select {
 case <-sigCh:
  l.Println("\ngoodbye")
  return
 case err := <-errCh:
  if err != nil {
   l.Fatal(err)
  }
 }
}
```

--------------------------------

### Create Slim Project Directory

Source: https://docs.kloudmate.com/guides/opentelemetry/php

Use Composer to initialize a new Slim project with necessary dependencies.

```bash
mkdir <project-name> && cd <project-name>

composer init \
 --no-interaction \
 --stability beta \
 --require slim/slim:"^4" \
 --require slim/psr7:"^1"
composer update
```

--------------------------------

### Create Django Project and App

Source: https://docs.kloudmate.com/guides/opentelemetry/python

Sets up a new Django project and a 'hello' app, and configures settings.

```python
django-admin startproject mysite .
python manage.py startapp hello
```

```python
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    ...
    'hello',
]
```

```python
from django.http import HttpResponse

def hello_world(request):
    return HttpResponse("Hello, World!")
```

```python
from django.urls import path
from .views import hello_world

urlpatterns = [
    path('', hello_world),
]
```

```python
from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('hello.urls')),
]
```

--------------------------------

### Create and Activate Virtual Environment (Flask)

Source: https://docs.kloudmate.com/guides/opentelemetry/python

Sets up a Python virtual environment and activates it for a Flask project.

```bash
python3 -m venv venv
source ./venv/bin/activate
```

--------------------------------

### Install KloudMate Agent on Linux VM

Source: https://docs.kloudmate.com/azure-integration/azure-application-gateway-log-monitoring

Use this command to install the KloudMate agent on a Linux virtual machine. Ensure you have curl installed.

```bash
curl -s https://install.kloudmate.com | bash
```

--------------------------------

### Install OpenTelemetry Collector on RPM (arm64)

Source: https://docs.kloudmate.com/opentelemetry/installing-the-opentelemetry-collector

Installs the OpenTelemetry Collector contrib package for arm64 architecture on RPM-based systems. Ensure wget and systemctl are installed.

```bash
sudo yum update
sudo yum -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.151.0/otelcol-contrib_0.151.0_linux_arm64.rpm
sudo rpm -ivh otelcol-contrib_0.151.0_linux_arm64.rpm
```

--------------------------------

### Install OpenTelemetry Collector on RPM (amd64)

Source: https://docs.kloudmate.com/opentelemetry/installing-the-opentelemetry-collector

Installs the OpenTelemetry Collector contrib package for amd64 architecture on RPM-based systems. Ensure wget and systemctl are installed.

```bash
sudo yum update
sudo yum -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.151.0/otelcol-contrib_0.151.0_linux_amd64.rpm
sudo rpm -ivh otelcol-contrib_0.151.0_linux_amd64.rpm
```

--------------------------------

### Install OpenTelemetry Collector on Debian (arm64)

Source: https://docs.kloudmate.com/opentelemetry/installing-the-opentelemetry-collector

Installs the OpenTelemetry Collector contrib package for arm64 architecture on Debian-based systems. Ensure wget and systemctl are installed.

```bash
sudo apt-get update
sudo apt-get -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.151.0/otelcol-contrib_0.151.0_linux_arm64.deb
sudo dpkg -i otelcol-contrib_0.151.0_linux_arm64.deb
```

--------------------------------

### Install OpenTelemetry Collector on Debian (amd64)

Source: https://docs.kloudmate.com/opentelemetry/installing-the-opentelemetry-collector

Installs the OpenTelemetry Collector contrib package for amd64 architecture on Debian-based systems. Ensure wget and systemctl are installed.

```bash
sudo apt-get update
sudo apt-get -y install wget systemctl
wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.151.0/otelcol-contrib_0.151.0_linux_amd64.deb
sudo dpkg -i otelcol-contrib_0.151.0_linux_amd64.deb
```

--------------------------------

### Initialize Go Module

Source: https://docs.kloudmate.com/guides/opentelemetry/go

Initializes the current directory as a Go module.

```bash
go mod init fib
```

--------------------------------

### Install OpenTelemetry Packages

Source: https://docs.kloudmate.com/guides/logs/send-winston-logs-with-opentelemetry-nodejs

Installs the necessary npm packages for OpenTelemetry logging.

```shell
npm i @opentelemetry/exporter-logs-otlp-http \
@opentelemetry/sdk-logs \
@opentelemetry/resources \
@opentelemetry/semantic-conventions
```

--------------------------------

### Run the Application

Source: https://docs.kloudmate.com/guides/opentelemetry/go

Executes the Go application from the current directory.

```bash
go run .
```

--------------------------------

### GCP cloud-init Instance Template

Source: https://docs.kloudmate.com/kloudmate-agent/installation/infrastructure-as-code-iaac-installation

Create a GCP instance template with user-data specified from a cloud-init file.

```bash
gcloud compute instance-templates create kmagent-template \
  --metadata-from-file user-data=cloud-init/cloud-init.yaml \
  --machine-type e2-medium \
  --image-family ubuntu-2204-lts \
  --image-project ubuntu-os-cloud
```

--------------------------------

### Create a new .NET Web Application

Source: https://docs.kloudmate.com/guides/opentelemetry/dotnet

Use this command to create a new basic ASP.NET Core minimal API web application.

```txt
dotnet new web
```

--------------------------------

### Install OpenTelemetry PHP Extension on macOS

Source: https://docs.kloudmate.com/apm-and-tracing/auto-instrumentation/php

Installs the OpenTelemetry PHP extension on macOS using pecl.

```bash
pecl install opentelemetry
```

--------------------------------

### Install OpenTelemetry Laravel Packages

Source: https://docs.kloudmate.com/apm-and-tracing/auto-instrumentation/php

Installs the required OpenTelemetry packages for Laravel zero-code instrumentation using Composer.

```bash
composer require open-telemetry/opentelemetry-auto-laravel
composer require open-telemetry/sdk
composer require open-telemetry/exporter-otlp
composer require open-telemetry/api
```

--------------------------------

### Configure OTLP Endpoint and Headers for PHP

Source: https://docs.kloudmate.com/apm-and-tracing/auto-instrumentation/php

Set these environment variables to route auto-instrumented data to KloudMate. Replace YOUR_API_KEY with your actual KloudMate API key.

```bash
export OTEL_EXPORTER_OTLP_ENDPOINT="https://otel.kloudmate.com:4318"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=YOUR_API_KEY"
export OTEL_SERVICE_NAME="your-php-service-name"
```

--------------------------------

### Configure Exporter and Pipelines

Source: https://docs.kloudmate.com/database-monitoring/database-integrations/postgresql-monitoring

Sets up the KloudMate backend exporter using OTLP/HTTP and defines pipelines for metrics and logs. Ensure the correct resourcedetection processor is applied.

```yaml
exporters:
  debug:
    verbosity: detailed
  otlphttp:
    endpoint: 'https://otel.kloudmate.com:4318'
    headers:
      Authorization: xxxxxxxx  # Use the auth key

service:
  pipelines:

    metrics:
      receivers: [postgresql]
      processors: [batch, resourcedetection, resource]  # Apply the correct resourcedetection
      exporters: [otlphttp]

    logs:
      receivers: [pgsql_log]    #use the correct filelog receiver as per your pg version
      processors: [batch, resourcedetection, resource]  # Apply the correct resourcedetection
      exporters: [otlphttp]

  extensions: [health_check, pprof, zpages, file_storage]
```

--------------------------------

### Configure .NET OTel Agent for KloudMate

Source: https://docs.kloudmate.com/apm-and-tracing/auto-instrumentation/dotnet

Set environment variables to route auto-instrumented .NET traces to KloudMate's OTLP endpoint. Replace YOUR_API_KEY with your actual KloudMate API key.

```bash
export OTEL_EXPORTER_OTLP_ENDPOINT="https://otel.kloudmate.com:4318"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=YOUR_API_KEY"
export OTEL_SERVICE_NAME="your-dotnet-service-name"
```

--------------------------------

### Alibaba Cloud cloud-init User Data

Source: https://docs.kloudmate.com/kloudmate-agent/installation/infrastructure-as-code-iaac-installation

Instructions for pasting cloud-init.yaml content into the ECS Console for Alibaba Cloud instances.

```text
Paste cloud-init.yaml content into: ECS Console → Instance → Advanced Options → User Data
```

--------------------------------

### Install Express and OpenTelemetry for TypeScript

Source: https://docs.kloudmate.com/guides/opentelemetry/node-js

Installs necessary packages for TypeScript development, including Express, ts-node, and the Node.js auto-instrumentation package.

```bash
npm install typescript ts-node @types/node express @types/express
npm install @opentelemetry/auto-instrumentations-node
```

--------------------------------

### Configure Node.js OTLP Endpoint and Headers

Source: https://docs.kloudmate.com/apm-and-tracing/auto-instrumentation/node-js

Set these environment variables to route auto-instrumented data to KloudMate. Replace YOUR_API_KEY with your actual KloudMate API key.

```bash
export OTEL_EXPORTER_OTLP_ENDPOINT="https://otel.kloudmate.com:4318"
export OTEL_EXPORTER_OTLP_HEADERS="Authorization=YOUR_API_KEY"
export OTEL_SERVICE_NAME="your-nodejs-service-name"
```

--------------------------------

### Install OpenTelemetry PHP Extension on Linux

Source: https://docs.kloudmate.com/apm-and-tracing/auto-instrumentation/php

Installs the necessary OpenTelemetry PHP extension on Ubuntu/Debian systems using apt and pecl.

```bash
sudo apt-get install php-dev php-pear
pecl install opentelemetry
```

--------------------------------

### Install OpenTelemetry PHP Packages

Source: https://docs.kloudmate.com/apm-and-tracing/manual-instrumentation/php

Install the required OpenTelemetry packages for PHP using Composer. This includes the API, SDK, and OTLP exporter.

```bash
composer require open-telemetry/api \
  open-telemetry/sdk \
  open-telemetry/exporter-otlp
```

--------------------------------

### Bash Script for Azure Integration and VM Setup

Source: https://docs.kloudmate.com/azure-integration/auto-integration-with-azure-monitor

This script automates the creation of an Azure AD application, service principal, and role assignment. It then deploys an Azure VM with a pre-configured OpenTelemetry Collector that sends metrics to KloudMate.

```bash
#!/bin/bash

# Check if App Name is provided
if [ -z "$1" ] || [ -z "$2" ]; then
    echo "Usage: $0 <App_Name> <Subscription_ID>"
    exit 1
fi

APP_NAME="$1"
ROLE="Reader"

# Get Subscription & Tenant ID
SUBSCRIPTION_ID="$2"
TENANT_ID=$(az account show --query tenantId --output tsv)

# Register an App in Azure AD
echo "Creating Azure AD App: $APP_NAME..."
APP_DETAILS=$(az ad app create --display-name "$APP_NAME" --query "{appId: appId, objectId: id}" --output json)
CLIENT_ID=$(echo "$APP_DETAILS" | grep -o '"appId": "[^"']*' | cut -d'"' -f4)
OBJECT_ID=$(echo "$APP_DETAILS" | grep -o '"id": "[^"']*' | cut -d'"' -f4)

# Create a Client Secret
echo "Creating Client Secret..."
SECRET_DETAILS=$(az ad app credential reset --id "$CLIENT_ID" --query "{password: password}" --output json)
CLIENT_SECRET=$(echo "$SECRET_DETAILS" | grep -o '"password": "[^"']*' | cut -d'"' -f4)

# Create a Service Principal for the App
echo "Creating Service Principal..."
az ad sp create --id "$CLIENT_ID" --output none

# Assign Reader Role to the App
echo "Assigning Reader role to the App..."
az role assignment create --assignee "$CLIENT_ID" --role "$ROLE" --scope "/subscriptions/$SUBSCRIPTION_ID"

# Output the credentials
echo "==========================="
echo "App Registration Completed!"
echo "App Name: $APP_NAME"
echo "Client ID: $CLIENT_ID"
echo "Tenant ID: $TENANT_ID"
echo "Subscription ID: $SUBSCRIPTION_ID"
echo "Client Secret (Save it securely!): $CLIENT_SECRET"
echo "==========================="

read -p "Enter Resource Group Name: " RESOURCE_GROUP
read -p "Enter VM Admin Username: " ADMIN_USER
read -s -p "Enter VM Admin Password: " ADMIN_PASSWORD
read -p "Enter Kloudmate Auth-Key: " AUTH_KEY
echo ""

VM_NAME="otel-vm-demo"
LOCATION="eastus"
IMAGE="Ubuntu2204"
SIZE="Standard_B2s"

CLOUD_INIT_FILE="cloud-init.yaml"

cat <<EOF > "$CLOUD_INIT_FILE"
#cloud-config
package_update: true
package_upgrade: true
runcmd:
  - wget https://github.com/open-telemetry/opentelemetry-collector-releases/releases/download/v0.120.0/otelcol-contrib_0.120.0_linux_amd64.deb
  - sudo dpkg -i otelcol-contrib_0.120.0_linux_amd64.deb
  - sudo systemctl enable otelcol-contrib
  - sudo systemctl start otelcol-contrib
  - echo "Updating OpenTelemetry config..."
  - sudo systemctl restart otelcol-contrib
write_files:
  - path: /etc/otelcol-contrib/otelcol-contrib.conf
    content: |
      OTELCOL_OPTIONS="--config=/etc/otelcol-contrib/config.yaml"
      SUBSCRIPTION_ID=${SUBSCRIPTION_ID}
      TENANT_ID=${TENANT_ID}
      CLIENT_ID=${CLIENT_ID}
      CLIENT_SECRET=${CLIENT_SECRET}
      AUTH_KEY=${AUTH_KEY}

  - path: /etc/otelcol-contrib/config.yaml
    content: |
      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:
           subscription_id: ${SUBSCRIPTION_ID}
           tenant_id: ${TENANT_ID}
           client_id: ${CLIENT_ID}
           client_secret: ${CLIENT_SECRET}
           cloud: AzureCloud
           collection_interval: 60s
           initial_delay: 1s

      processors:
         batch:
           send_batch_size: 10000
           timeout: 30s

      exporters:
         debug:
           verbosity: detailed

         otlphttp:
           endpoint: "https://otel.kloudmate.com:4318"
           headers:
             Authorization: ${AUTH_KEY}  # Replace with your actual KloudMate authentication key

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

         extensions: [health_check, pprof, zpages]
EOF

echo "Creating Azure VM: $VM_NAME..."

az vm create --resource-group "$RESOURCE_GROUP" --name "$VM_NAME" --image "$IMAGE" --size "$SIZE" --admin-username "$ADMIN_USER" --admin-password "$ADMIN_PASSWORD" --custom-data "$CLOUD_INIT_FILE"

```

--------------------------------

### Install OTLP Exporter Package

Source: https://docs.kloudmate.com/guides/opentelemetry/python

Installs the OpenTelemetry OTLP exporter package using pip, enabling export of spans and metrics via OTLP.

```bash
pip install opentelemetry-exporter-otlp
```
Tokens:
Raw