Add some code examples using @simonswine repo.

Co-authored-by: Christian Simon  <[email protected]>

Author: cyriltovena

examples/README.md

@@ -0,0 +1,3 @@
+# Examples
+
+We've compiled a set of examples using [docker-compose](./tools/docker-compose/) to help you get started with your language of choice.

tools/docker-compose/docker-compose.yml

@@ -15,19 +15,39 @@ services:
       - phlare
 
   grafana:
-    image: aocenas/grafana:profiling-ds
+    image: aocenas/grafana:profiling-ds-2@sha256:34e6cf8c315c8efea3368cdadbc448d671f791df02a8dbb75f7376e323cb3dab
     ports:
       - "3000:3000"
     environment:
       - GF_FEATURE_TOGGLES_ENABLE=flameGraph
       - GF_AUTH_ANONYMOUS_ENABLED=true
       - GF_AUTH_ANONYMOUS_ORG_ROLE=Admin
+      - GF_DIAGNOSTICS_PROFILING_ENABLED=true
+      - GF_DIAGNOSTICS_PROFILING_ADDR=0.0.0.0
+      - GF_DIAGNOSTICS_PROFILING_PORT=6060
     volumes:
       - ./datasource.yaml:/etc/grafana/provisioning/datasources/datasources.yml
     networks:
       - phlare
 
+  python:
+    build:
+      context: python
+      dockerfile: Dockerfile
+    ports:
+      - 8081:8081
+    networks:
+      - phlare
+  rust:
+    build:
+      context: rust
+      dockerfile: Dockerfile
+    ports:
+      - 8080:3000
+    networks:
+      - phlare
+
 volumes:
   data:
 
-# yaml-language-server: $schema=https://raw.githubusercontent.com/compose-spec/compose-spec/master/schema/compose-spec.json
+    # yaml-language-server: $schema=https://raw.githubusercontent.com/compose-spec/compose-spec/master/schema/compose-spec.json

tools/docker-compose/phlare.yaml

@@ -1,5 +1,28 @@
 scrape_configs:
-  - job_name: "default"
+  - job_name: "phlare"
     scrape_interval: "15s"
     static_configs:
       - targets: ["phlare:4100"]
+  - job_name: "grafana"
+    scrape_interval: "15s"
+    static_configs:
+      - targets: ["grafana:6060"]
+  - job_name: "cp-rust"
+    scrape_interval: "15s"
+    static_configs:
+      - targets: ["rust:3000"]
+    profiling_config:
+      pprof_config:
+        block: { enabled: false }
+        goroutine: { enabled: false }
+        memory: { enabled: false }
+        mutex: { enabled: false }
+  - job_name: "cp-python"
+    scrape_interval: "15s"
+    static_configs:
+      - targets: ["python:8081"]
+    profiling_config:
+      pprof_config:
+        block: { enabled: false }
+        goroutine: { enabled: false }
+        mutex: { enabled: false }

tools/docker-compose/python/Dockerfile

@@ -0,0 +1,27 @@
+FROM python:3.10 as builder
+
+# Install build-base to allow for compilation of the profiling agent.
+RUN apt-get update && apt-get install -y build-essential git
+
+# Compile the profiling agent, generating wheels for it.
+COPY requirements.txt .
+RUN pip3 wheel --wheel-dir=/tmp/wheels -r requirements.txt
+
+FROM python:3.10
+
+# Copy over the directory containing wheels for the profiling agent.
+COPY --from=builder /tmp/wheels /tmp/wheels
+RUN ls -al
+
+RUN apt-get update && apt-get install -y git
+
+# Install the profiling agent.
+COPY requirements.txt .
+COPY main.py .
+
+RUN pip3 install --no-index --find-links=/tmp/wheels -r requirements.txt
+
+
+# Run the application when the docker image is run, using either CMD (as is done
+# here) or ENTRYPOINT.
+CMD python3 -u main.py

tools/docker-compose/python/README.md

@@ -0,0 +1,16 @@
+# Continuous Profiling for Python
+
+The use of [zprofile] requires to build the wheel for the particular libraries shipped, locally refer to the [Dockerfile] how to achieve this.
+
+## Run backend
+
+```shell
+$ docker build -t cp-python .
+$ docker run -p 8081:8081 cp-python
+```
+
+## Collect profiles
+
+```shell
+$ pprof -http :6060 "http://localhost:8081/debug/pprof/profile?seconds=1"
+```

tools/docker-compose/python/main.py

@@ -0,0 +1,36 @@
+import time
+
+# import profiling modules
+from pypprof.net_http import start_pprof_server
+import mprofile
+
+def prime_number_from_1_to(to=100):
+    prime_numbers = []
+    for i in range(1, to):
+        if i > 1:
+            for j in range(2, i):
+                if divisible(i, j):
+                    break
+            else:
+                prime_numbers.append(i)
+    return prime_numbers
+
+def divisible(i, j):
+    return i % j == 0
+
+
+def main():
+    # start memory profiling
+    mprofile.start(sample_rate=128 * 1024)
+
+    # enable pprof http server
+    start_pprof_server(host='0.0.0.0', port=8081)
+
+    to = 500
+    while True:
+        result = prime_number_from_1_to(to)
+        print("there are %d prime numbers from 1 to %d" % (len(result), to))
+        time.sleep(0.5)
+
+if __name__ == "__main__":
+    main()

tools/docker-compose/python/requirements.txt

@@ -0,0 +1,5 @@
+mprofile==0.0.14
+protobuf==3.20.3
+git+https://github.com/simonswine/pypprof.git@a5b539b839f9eb91be9277ae22c1698eac9e5ce8#egg=pypprof
+six==1.16.0
+git+https://github.com/simonswine/zprofile.git@100934da015661b3baf7c7c45f68293546ba77f5#egg=zprofile

tools/docker-compose/rust/.dockerignore

@@ -0,0 +1,2 @@
+/target/
+/.git/

tools/docker-compose/rust/.gitignore

@@ -0,0 +1 @@
+/target