Start documentation. Created Quickstart steps

Author: alhendrickson

observability/docs/get-started/quickstart.md

@@ -0,0 +1,86 @@
+## QuickStart
+
+This tutorial guides you through running the simplest setup of the observability stack using example configuration files and Docker Compose.
+
+After completing these steps, you will have a full observability stack running locally, showing the availability of web pages you want to target
+
+### Requirements
+
+- Docker installed ([install Docker](https://docs.docker.com/get-docker/))
+- Docker Compose installed ([install Docker Compose](https://docs.docker.com/compose/install/))
+- A terminal with network access
+
+### Step 1: Download the sample files
+
+Create a folder on your machine, then download these two files from GitHub into it:
+
+- `docker-compose.yml`
+- `prometheus-config.yml`
+
+You can do this manually or by running:
+
+```bash
+mkdir observability-stack
+cd observability-stack
+curl -O https://github.com/CogStack/cogstack-platform-toolkit/blob/main/observability/examples/simple/docker-compose.yml
+curl -O https://github.com/CogStack/cogstack-platform-toolkit/blob/main/observability/examples/simple/probe-simple.yml
+```
+
+### Step 2: Start the stack
+
+In the folder containing the downloaded files, run:
+
+```bash
+docker compose up -d
+```
+
+### Step 3: Access the dashboards
+Open your web browser and go to:
+
+`localhost/grafana`
+
+You should see the Grafana dashboard displaying the availability of the sample web page.
+
+There it is, you can now see the availability of the cogstack homepage, as well as the observability stack
+
+### Step 4: Probe your own web page
+Now you can look at getting monitoring on your own page.
+
+In your current folder, edit the file `probe-simple.yml` that you downloaded from git.
+
+Add the following yml to the bottom of the file:
+
+```yaml
+- targets:
+    - https://google.com
+  labels:
+    name: google
+    job: probe-my-own-site
+```
+
+
+The change should get applied automatically, but if you dont want to wait then run
+
+```
+docker compose restart
+```
+
+Now refresh the grafana dashboard, and you can see the availability of google.com, it's probably 100%!
+
+
+## Next steps
+This is the end of this quickstart tutorial, that enables probing availability of endpoints.
+
+For the next steps we can:
+- Productionise our deployment to enable further features
+- Enable *Telemetry* like VM memory usage, and Elasticsearch index size, by running Exporters
+- Enable *Alerting* based on our availability and a defined Service Level Objective (SLO)
+- Look further into the available dashboards
+- Fully customize the stack with our own dashboards, recording rules and metrics
+-
+
+
+
+
+
+

observability/docs/get-started/setup-tutorial.md

@@ -0,0 +1,17 @@
+
+This page 
+
+
+
+## Run the Observability Stack using Docker Compose
+
+See the /examples folder for a working example of running this
+
+To setup the stack for your deployment:
+- Create prometheus configurations as listed below
+- Copy this docker-compose.yml file
+- Mount your site config files into `/etc/prometheus/cogstack/site` 
+- Run with docker compose
+
+To collect metrics from VMs to fill out the dashboards
+- Run the Exporters on each VM as detailed below

observability/docs/get-started/userguide-tutorial.md

@@ -0,0 +1,18 @@
+# Cogstack Observability Stack
+
+This project provides observability of a cogstack deployment.
+
+It provides the following features:
+- Dashboards for availability
+- Telemetry of infrastructure such as host memory usage, and elasticsearch index size
+- Alerting based on a defined Service Level Objective (SLO) and burn rates
+- Blackbox Probing of services to find service level indicators of uptime and latency
+- A working inventory of what is running where
+
+## Contents
+
+See the [Quickstart](./get-started/quickstart.md) to see how to easily run this stack.
+
+
+
+

observability/docs/overview.md

@@ -6,7 +6,7 @@ services:
     image: cogstacksystems/cogstack-observability-prometheus:latest
     restart: unless-stopped
     volumes:
-      - ./prometheus:/etc/prometheus/cogstack/site
+      - ./probe-simple.yml:/etc/prometheus/cogstack/site/scrape-configs/probers/probe-simple.yml
       - prometheus-data:/prometheus
     networks:
       - observability
@@ -17,8 +17,6 @@ services:
       - grafana-data:/var/lib/grafana
     networks:
       - observability
-    ports:
-     - '3000:3000'
     environment:
       - GF_AUTH_ANONYMOUS_ENABLED=true # Allows use of grafana without sign in 
       - GF_AUTH_ANONYMOUS_ORG_ROLE=Viewer
@@ -28,17 +26,14 @@ services:
      - observability
     restart: unless-stopped
     ports:
-      - "80:80"
-      - "8080:8080"
+      - "180:80"
     volumes:
       - /var/run/docker.sock:/var/run/docker.sock:ro       # So that Traefik can listen to the Docker events
   blackbox-exporter:
     image: cogstacksystems/cogstack-observability-blackbox-exporter:latest
     restart: unless-stopped
-    ports:
-    - "9115:9115"
     networks:
-      - observability-exporters
+      - observability
 networks:
   observability:
     driver: bridge

observability/examples/simple/docker-compose.yml

@@ -0,0 +1,11 @@
+# Example of probe targets
+- targets:
+    - https://cogstack.org
+  labels:
+    name: cogstack-homepage
+    job: probe-services
+- targets:
+    - https://google.com
+  labels:
+    name: google
+    job: probe-services