docs: adds an otelcollector example

examples/otelcollector/README.md

@@ -0,0 +1,30 @@
+# Grafana Agent pull mode integration
+
+This example demonstrates how you can use Grafana Agent with Grafana Pyroscope to profile otel collector.
+
+### 1. Configure Grafana agent
+
+For Grafana Alloy to pull profiles from your application, configure the agent for things like profiling configuration, targets, and possibly authentication.
+
+You can find a list of [arguments](https://grafana.com/docs/agent/next/flow/reference/components/pyroscope.scrape/#arguments) and [supported blocks](https://grafana.com/docs/agent/next/flow/reference/components/pyroscope.scrape/#blocks) in the [Grafana Agent documentation for Pyroscope](https://grafana.com/docs/agent/next/flow/reference/components/pyroscope.scrape/)
+
+Refer to [config file](./agent/config/config.river) to see an example of how to configure Grafana Agent to send profiling data to Pyroscope.
+
+### 2. Run Grafana agent, Grafana, and Pyroscope
+
+```shell
+docker-compose up -d
+```
+
+### 3. Observe profiling data
+
+Now that everything is set up, you can browse profiling data via [Grafana UI](http://localhost:3000).
+
+#### Explore view
+For showing profiling data alongside traces
+![image](https://github.com/grafana/pyroscope/assets/23323466/a9c2f28c-d35a-49b0-a3bc-678d3fbdd321)
+
+#### Dashboard
+For showing real-time overview of profiling data
+![image](https://github.com/grafana/pyroscope/assets/23323466/59a84d0c-87d2-4cfc-8e34-b54576cb6540)
+

examples/otelcollector/agent/config/agent.yaml

@@ -0,0 +1,2 @@
+server:
+  log_level: info

examples/otelcollector/agent/config/config.river

@@ -0,0 +1,28 @@
+logging {
+  level = "debug"
+  format = "logfmt"
+}
+
+pyroscope.write "example" {
+  // Send metrics to a locally running Phlare instance.
+  endpoint {
+    url = "http://pyroscope:4040"
+
+    // To send data to Grafana Cloud you'll need to provide username and password.
+    // basic_auth {
+    //   username = "myuser"
+    //   password = "mypassword"
+    // }
+  }
+  external_labels = {
+    "env" = "example",
+  }
+}
+
+
+pyroscope.scrape "default" {
+  targets = [
+    {"__address__" = "otelcollector:6060", "service_name"="otelcollector"},
+  ]
+  forward_to = [pyroscope.write.example.receiver]
+}

examples/otelcollector/docker-compose.yml

@@ -0,0 +1,41 @@
+version: '3.9'
+services:
+  grafana:
+    image: grafana/grafana:latest
+    volumes:
+      - ./grafana-provisioning:/etc/grafana/provisioning
+      - ./grafana/grafana.ini:/etc/grafana/grafana.ini
+      - ./grafana/home.json:/default-dashboard.json
+    ports:
+      - 3000:3000
+
+  pyroscope:
+    image: 'grafana/pyroscope:1.0.0-rc.0'
+    ports:
+      - 4040:4040
+    command: -config.file=/etc/pyroscope/config.yaml
+    volumes:
+      - ./pyroscope/config.yaml:/etc/pyroscope/config.yaml
+
+  agent:
+    image: grafana/agent:latest
+    volumes:
+      - ./agent/config:/etc/agent-config
+    command:
+      - run
+      - /etc/agent-config/config.river
+      - --server.http.listen-addr=0.0.0.0:12345
+    environment:
+      HOSTNAME: agent
+      AGENT_MODE: flow
+    ports:
+      - "12345:12345"
+
+  otelcollector:
+    image: otel/opentelemetry-collector:0.67.0
+    restart: always
+    command: ["--config=/etc/otelcollector.yaml"]
+    volumes:
+      - ./otelcollector.yaml:/etc/otelcollector.yaml
+    ports:
+      - "6060:6060"   # pprof extension

examples/otelcollector/grafana-provisioning/dashboards/main.json

@@ -0,0 +1,71 @@
+{
+  "annotations": {
+    "list": []
+  },
+  "editable": true,
+  "fiscalYearStartMonth": 0,
+  "graphTooltip": 1,
+  "links": [],
+  "liveNow": false,
+  "panels": [
+    {
+      "datasource": {
+        "type": "phlare",
+        "uid": "pyroscope"
+      },
+      "gridPos": {
+        "h": 19,
+        "w": 24,
+        "x": 0,
+        "y": 0
+      },
+      "id": 1,
+      "targets": [
+        {
+          "datasource": {
+            "type": "phlare",
+            "uid": "pyroscope"
+          },
+          "groupBy": [],
+          "labelSelector": "{}",
+          "profileTypeId": "process_cpu:cpu:nanoseconds:cpu:nanoseconds",
+          "queryType": "profile",
+          "refId": "A"
+        }
+      ],
+      "title": "Panel Title",
+      "type": "flamegraph"
+    }
+  ],
+  "refresh": "5s",
+  "schemaVersion": 38,
+  "style": "dark",
+  "tags": [],
+  "templating": {
+    "list": []
+  },
+  "time": {
+    "from": "now-15m",
+    "to": "now"
+  },
+  "timepicker": {
+    "refresh_intervals": [
+      "5s",
+      "10s",
+      "30s",
+      "1m",
+      "5m",
+      "15m",
+      "30m",
+      "1h",
+      "2h",
+      "1d"
+    ],
+    "time_options": ["5m", "15m", "1h", "6h", "12h", "24h", "2d", "7d", "30d"]
+  },
+  "timezone": "browser",
+  "title": "main",
+  "uid": "65gjqY3Mk",
+  "version": 1,
+  "weekStart": ""
+}

examples/otelcollector/grafana-provisioning/dashboards/main.yml

@@ -0,0 +1,8 @@
+apiVersion: 1
+
+providers:
+  - name: dashboards
+    type: file
+    updateIntervalSeconds: 5
+    options:
+      path: /etc/grafana/provisioning/dashboards

examples/otelcollector/grafana-provisioning/datasources/datasources.yml

@@ -0,0 +1,12 @@
+---
+apiVersion: 1
+datasources:
+  - name: Pyroscope
+    orgId: 1
+    uid: pyroscope
+    type: 'phlare'
+    access: 'proxy'
+    grafanaOrgId: 1
+    url: http://pyroscope:4040
+    isDefault: true
+    editable: true