ADD: grafana example

Author: gdj0nes

grafana_monitoring/README.md

@@ -0,0 +1,42 @@
+# Monitoring
+
+Learn how to configure Prometheus & Grafana to monitor your Pinecone Projects with Docker Compose.
+
+## Configuration
+
+Each Project needs to be configured with its own Prometheus scraper. You will need a Pinecone API
+Key to authorize Prometheus to fetch the metrics. For the target, you need to specify the Project's region, 
+for example `us-west1-gcp`. Update the file found at `./prometheus/config.yml`
+
+```yaml
+scrape_configs:
+  - job_name: pinecone-project-1
+    authorization:
+      credentials: <APIKEY>
+    scheme: https
+    static_configs:
+      - targets: [ 'metrics.<PROJECT REGION>.pinecone.io' ]
+```
+
+
+### Grafana
+
+Grafana is configured by default to run against the local Prometheus instance. A sample dashboard
+for monitoring all indexes in a Project is preloaded into Grafana. You can add this dashboard to your own
+Grafana instance by copying `./grafana/dashbords/pinecone.json`.
+
+## Run
+
+Start docker compose
+
+```shell
+docker-compose up
+```
+
+Check the ports Grafana and Promethus are running on
+
+```shell
+docker-compose ps
+```
+
+Open Grafana in your browser an navigate to Dashboard. The default dashboard is a folder titled Pinecone. 

grafana_monitoring/docker-compose.yml

@@ -0,0 +1,31 @@
+version: '2.1'
+
+volumes:
+  prometheus_data: { }
+  grafana_data: { }
+
+services:
+  prometheus:
+    image: prom/prometheus
+    container_name: prometheus
+    volumes:
+      - ./prometheus:/etc/prometheus
+      - prometheus_data:/prometheus
+    command:
+      - '--config.file=/etc/prometheus/config.yml'
+      - '--storage.tsdb.path=/prometheus'
+      - '--web.console.libraries=/etc/prometheus/console_libraries'
+      - '--web.console.templates=/etc/prometheus/consoles'
+      - '--storage.tsdb.retention.time=200h'
+      - '--web.enable-lifecycle'
+    ports:
+      - "9090"
+  grafana:
+    image: grafana/grafana-oss
+    container_name: grafana
+    volumes:
+      - grafana_data:/var/lib/grafana
+      - ./grafana/provisioning:/etc/grafana/provisioning
+      - ./grafana/dashboards:/var/lib/grafana/dashboards
+    ports:
+      - 3000:3000