From ecbbc532130c010a9da68bd20b53d548eaf20449 Mon Sep 17 00:00:00 2001
From: chrisakker <38477223+chrisakker@users.noreply.github.com>
Date: Mon, 10 Apr 2023 11:22:58 -0700
Subject: [PATCH] Akker (#41)
* added icons
* added icons
* http upgrade
* add grafana dashboard
* updated diagram
---
docs/InstallationGuide.md | 65 +-
docs/cafe.yaml | 70 ++
docs/http/clusters.conf | 129 +++
docs/http/grafana-dashboard.json | 1346 ++++++++++++++++++++++
docs/http/nginx.conf | 47 +
docs/http/prometheus.conf | 18 +
docs/http/prometheus.yml | 14 +
docs/http/zonesync.conf | 19 +
docs/media/cafe-dashboard.png | Bin 0 -> 200082 bytes
docs/media/kubernetes-icon.png | Bin 0 -> 5601 bytes
docs/media/linux-icon.png | Bin 0 -> 5485 bytes
docs/media/nginx-2020.png | Bin 0 -> 19331 bytes
docs/media/nginx-icon.png | Bin 0 -> 9417 bytes
docs/media/nginx-ingress-icon.png | Bin 0 -> 4642 bytes
docs/media/nginx-logo.png | Bin 0 -> 22586 bytes
docs/media/nginx-plus-icon.png | Bin 0 -> 27860 bytes
docs/media/nginxlb-multicluster-http.png | Bin 0 -> 744306 bytes
docs/media/nginxlb-multicluster.png | Bin 0 -> 519194 bytes
docs/media/nginxredplus.png | Bin 0 -> 4233 bytes
docs/media/nkl-background.png | Bin 209535 -> 426020 bytes
docs/media/nkl-banner.png | Bin 0 -> 116981 bytes
docs/media/robot.svg | 163 +++
22 files changed, 1861 insertions(+), 10 deletions(-)
create mode 100644 docs/cafe.yaml
create mode 100644 docs/http/clusters.conf
create mode 100644 docs/http/grafana-dashboard.json
create mode 100644 docs/http/nginx.conf
create mode 100644 docs/http/prometheus.conf
create mode 100644 docs/http/prometheus.yml
create mode 100644 docs/http/zonesync.conf
create mode 100644 docs/media/cafe-dashboard.png
create mode 100644 docs/media/kubernetes-icon.png
create mode 100644 docs/media/linux-icon.png
create mode 100644 docs/media/nginx-2020.png
create mode 100644 docs/media/nginx-icon.png
create mode 100644 docs/media/nginx-ingress-icon.png
create mode 100644 docs/media/nginx-logo.png
create mode 100644 docs/media/nginx-plus-icon.png
create mode 100644 docs/media/nginxlb-multicluster-http.png
create mode 100644 docs/media/nginxlb-multicluster.png
create mode 100644 docs/media/nginxredplus.png
create mode 100644 docs/media/nkl-banner.png
create mode 100644 docs/media/robot.svg
diff --git a/docs/InstallationGuide.md b/docs/InstallationGuide.md
index 504f099..dca643d 100644
--- a/docs/InstallationGuide.md
+++ b/docs/InstallationGuide.md
@@ -6,10 +6,15 @@
+ |  | 
+--- | --- | ---
+
+
+
## Pre-Requisites
- Working kubernetes cluster, with admin privleges
-- Running nginx-ingress controller, either OSS or Plus. This install guide follows the instructions for deploying an Nginx Ingress Controller here: https://docs.nginx.com/nginx-ingress-controller/installation/installation-with-manifests/
+- Running nginx-ingress controller, either OSS or Plus. This install guide followed the instructions for deploying an Nginx Ingress Controller here: https://docs.nginx.com/nginx-ingress-controller/installation/installation-with-manifests/
- Demo application, this install guide uses the Nginx Cafe example, found here: https://github.com/nginxinc/kubernetes-ingress/tree/main/examples/ingress-resources/complete-example
- A bare metal Linux server or VM for the external LB Server, connected to a network external to the cluster. Two of these will be required if High Availability is needed, as shown here.
- Nginx Plus software loaded on the LB Server(s). This install guide follows the instructions for installing Nginx Plus on Centos 7, located here: https://docs.nginx.com/nginx/admin-guide/installing-nginx/installing-nginx-plus/
@@ -19,15 +24,29 @@
## Kubernetes Cluster
+
+
+
+
+
+
A standard K8s cluster is all that is required. There must be enough resources available to run the Nginx Ingress Controller, and the Nginx Kubernetes Loadbalancer Controller. You must have administrative access to be able to create the namespace, services, and deployments for this Solution. This Solution was tested on Kubernetes version 1.23. Most recent versions => v1.21 should work just fine.
## Nginx Ingress Controller
+
+
+
+
+
+
The Nginx Ingress Controller in this Solution is the destination target for traffic (north-south) that is being sent to the cluster. The installation of the actual Ingress Controller is outside the scope of this installation guide, but we include the links to the docs for your reference. `The NIC installation must follow the documents exactly as written,` as this Solution refers to the `nginx-ingress` namespace and service objects. **Only the very last step is changed.**
-NOTE: This Solution only works with nginx-ingress from Nginx. It will `not` work with the Community version of Ingress, called ingress-nginx. If you are unsure which Ingress Controller you are running, check out the blog on Nginx.com:
+NOTE: This Solution only works with nginx-ingress from Nginx. It will `not` work with the Community version of Ingress, called ingress-nginx.
+
+If you are unsure which Ingress Controller you are running, check out the blog on Nginx.com:
https://www.nginx.com/blog/guide-to-choosing-ingress-controller-part-4-nginx-ingress-controller-options
@@ -62,23 +81,35 @@ spec:
```
+Apply the updated nodeport-nkl.yaml Manifest:
```bash
kubectl apply -f nodeport-nkl.yaml
```
+
+## Demo Application
-## Demo Application
+
-This is not part of the actual Solution, but it is useful to have a well-known application running in the cluster, as a useful target for test commands. The example provided here is used by the Solution to demonstrate proper traffic flows, and application health check monitoring, to determine if the application is running in the cluster. If you choose a different Application to test with, the health checks provided here will NOT work, and will need to be modified to work correctly.
+
+
+This is not part of the actual Solution, but it is useful to have a well-known application running in the cluster, as a known-good target for test commands. The example provided here is used by the Solution to demonstrate proper traffic flows, as well as application health check monitoring, to determine if the application is running in the cluster.
+
+Note: If you choose a different Application to test with, `the Nginx health checks provided here will NOT work,` and will need to be modified to work correctly.
- Deploy the Nginx Cafe Demo application, found here:
https://github.com/nginxinc/kubernetes-ingress/tree/main/examples/ingress-resources/complete-example
+- The Cafe Demo Docker image used is an upgraded one, with graphics and additional Request and Response variables added.
+
+https://hub.docker.com/r/nginxinc/ingress-demo
+You can use the `cafe.yaml` manifest included.
+
- Do not use the `cafe-ingress.yaml` file. Rather, use the `cafe-virtualserver.yaml` file that is provided here. It uses the Nginx CRDs to define a VirtualServer, and the related Routes and Redirects needed. The `redirects are required` for the LB Server's health checks to work correctly!
```yaml
@@ -143,9 +174,12 @@ spec:
## Linux VM or bare-metal LB Server
-This is a standard Linux OS system, based on the Linux Distro and Technical Specs required for Nginx Plus, which can be found here: https://docs.nginx.com/nginx/technical-specs/
+
+
-This installation guide followed the "Installation of Nginx Plus on Centos/Redhat/Oracle" steps for installing Nginx Plus.
+This is any standard Linux OS system, based on the Linux Distro and Technical Specs required for Nginx Plus, which can be found here: https://docs.nginx.com/nginx/technical-specs/
+
+This Solution followed the "Installation of Nginx Plus on Centos/Redhat/Oracle" steps for installing Nginx Plus.
>NOTE: This solution will not work with Nginx OpenSource, as OpenSource does not have the API that is used in this Solution. Installation on unsupported Distros is not recommended or supported.
@@ -153,11 +187,17 @@ This installation guide followed the "Installation of Nginx Plus on Centos/Redha
## Nginx Plus LB Server
+
+
+
+
+
+
This is the configuration required for the LB Server, external to the cluster. It must be configured for the following.
- Move the Nginx default Welcome page from port 80 to port 8080. Port 80 will be used by the stream context, instead of the http context.
- API write access enabled on port 9000.
-- Plus Dashboard enabled, used for testing, monitoring, and visualization of the solution working.
+- Plus Dashboard enabled, used for testing, monitoring, and visualization of the Solution working.
- The `Stream` context is enabled, for TCP loadbalancing.
- Stream context is configured.
@@ -202,13 +242,13 @@ server {
-- Create a new folder for the stream config .conf files. /etc/nginx/stream was used in this Solution.
+- Create a new folder for the stream config .conf files. /etc/nginx/stream is used in this Solution.
```bash
mkdir /etc/nginx/stream
```
-- Create 2 new `STATE` files for Nginx. These are used to backup the configuration, in case Nginx restarts/reloads.
+- Create 2 new `STATE` files for Nginx. These are used to backup the Upstream configuration, in case Nginx is restarted/reloaded.
Nginx State Files Required for Upstreams
- state file /var/lib/nginx/state/nginx-lb-http.state
@@ -289,7 +329,7 @@ stream {
`Notice that is uses Ports 80 and 443.`
- Place this file in the /etc/nginx/stream folder.
+ Place this file in the /etc/nginx/stream folder, and reload Nginx. Notice the match block and health check directives are for the cafe.example.com Demo application from Nginx.
```bash
# NginxK8sLB Stream configuration, for L4 load balancing
@@ -338,6 +378,11 @@ stream {
+
+
+
+
+
This is the new Controller, which is configured to watch the k8s environment, the nginx-ingress Service object, and send API updates to the Nginx LB Server when there are changes. It only requires three things.
- New kubernetes namespace and RBAC
diff --git a/docs/cafe.yaml b/docs/cafe.yaml
new file mode 100644
index 0000000..6736ec8
--- /dev/null
+++ b/docs/cafe.yaml
@@ -0,0 +1,70 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+ name: coffee
+spec:
+ replicas: 3
+ selector:
+ matchLabels:
+ app: coffee
+ template:
+ metadata:
+ labels:
+ app: coffee
+ spec:
+ containers:
+ - name: coffee
+ image: nginxinc/ingress-demo # upgraded Cafe Docker image
+ ports:
+ - containerPort: 80
+---
+apiVersion: v1
+kind: Service
+metadata:
+ name: coffee-svc
+spec:
+ type: ClusterIP
+ clusterIP: None
+ ports:
+ - port: 80
+ targetPort: 80
+ protocol: TCP
+ name: http
+ selector:
+ app: coffee
+---
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+ name: tea
+spec:
+ replicas: 3
+ selector:
+ matchLabels:
+ app: tea
+ template:
+ metadata:
+ labels:
+ app: tea
+ spec:
+ containers:
+ - name: tea
+ image: nginxinc/ingress-demo
+ ports:
+ - containerPort: 80
+---
+apiVersion: v1
+kind: Service
+metadata:
+ name: tea-svc
+ labels:
+spec:
+ type: ClusterIP
+ clusterIP: None
+ ports:
+ - port: 80
+ targetPort: 80
+ protocol: TCP
+ name: http
+ selector:
+ app: tea
diff --git a/docs/http/clusters.conf b/docs/http/clusters.conf
new file mode 100644
index 0000000..58ea593
--- /dev/null
+++ b/docs/http/clusters.conf
@@ -0,0 +1,129 @@
+# NginxK8sLB HTTP configuration, for L7 load balancing
+# Chris Akker, Apr 2023
+# HTTP Proxy and load balancing
+# 2 k8s Clusters LB with http split clients
+# Nginx Kubernetes Loadbalancer
+# Upstream servers managed by NKL Controller
+# Nginx Key Value store for Split ratios
+#
+#### clusters.conf
+
+# Define Key Value store, backup state file, timeout, and enable sync
+
+keyval_zone zone=split:1m state=/var/lib/nginx/state/split.keyval timeout=30d sync;
+ keyval $host $split_level zone=split;
+
+# Main Nginx Server Block for cafe.example.com, with TLS
+
+server {
+ listen 443 ssl;
+ status_zone https://cafe.example.com;
+ server_name cafe.example.com;
+
+ ssl_certificate /etc/ssl/nginx/default.crt;
+ ssl_certificate_key /etc/ssl/nginx/default.key;
+
+ location / {
+ status_zone /;
+
+ proxy_set_header Host $host;
+ proxy_http_version 1.1;
+ proxy_set_header "Connection" "";
+ proxy_pass https://$upstream;
+
+ }
+
+}
+
+# Cluster1 upstreams
+
+upstream cluster1-https {
+ zone cluster1-https 256k;
+ least_time last_byte;
+ server 10.1.1.10:31317;
+ server 10.1.1.8:31317;
+ keepalive 16;
+ #servers managed by NKL
+ #state /var/lib/nginx/state/cluster1-https.state;
+}
+
+# Cluster2 upstreams
+
+upstream cluster2-https {
+ zone cluster2-https 256k;
+ least_time last_byte;
+ server 10.1.1.11:31390;
+ server 10.1.1.12:31390;
+ #servers managed by NKL
+ #state /var/lib/nginx/state/cluster2-https.state;
+}
+
+# HTTP Split Clients Configuration for Cluster1/Cluster2 ratios
+
+split_clients $request_id $split0 {
+ * cluster2-https;
+ }
+
+split_clients $request_id $split1 {
+ 1.0% cluster1-https;
+ * cluster2-https;
+ }
+
+split_clients $request_id $split5 {
+ 5.0% cluster1-https;
+ * cluster2-https;
+ }
+
+split_clients $request_id $split10 {
+ 10% cluster1-https;
+ * cluster2-https;
+ }
+
+split_clients $request_id $split25 {
+ 25% cluster1-https;
+ * cluster2-https;
+ }
+
+split_clients $request_id $split50 {
+ 50% cluster1-https;
+ * cluster2-https;
+ }
+
+split_clients $request_id $split75 {
+ 75% cluster1-https;
+ * cluster2-https;
+ }
+
+split_clients $request_id $split90 {
+ 90% cluster1-https;
+ * cluster2-https;
+ }
+
+split_clients $request_id $split95 {
+ 95% cluster1-https;
+ * cluster2-https;
+ }
+
+split_clients $request_id $split99 {
+ 99% cluster1-https;
+ * cluster2-https;
+ }
+
+split_clients $request_id $split100 {
+ * cluster1-https;
+ }
+
+map $split_level $upstream {
+ 0 $split0;
+ 1.0 $split1;
+ 5.0 $split5;
+ 10 $split10;
+ 25 $split25;
+ 50 $split50;
+ 75 $split75;
+ 90 $split90;
+ 95 $split95;
+ 99 $split99;
+ 100 $split100;
+ default $split50;
+ }
diff --git a/docs/http/grafana-dashboard.json b/docs/http/grafana-dashboard.json
new file mode 100644
index 0000000..b032697
--- /dev/null
+++ b/docs/http/grafana-dashboard.json
@@ -0,0 +1,1346 @@
+{
+ "annotations": {
+ "list": [
+ {
+ "builtIn": 1,
+ "datasource": {
+ "type": "datasource",
+ "uid": "grafana"
+ },
+ "enable": true,
+ "hide": true,
+ "iconColor": "rgba(0, 211, 255, 1)",
+ "name": "Annotations & Alerts",
+ "target": {
+ "limit": 100,
+ "matchAny": false,
+ "tags": [],
+ "type": "dashboard"
+ },
+ "type": "dashboard"
+ }
+ ]
+ },
+ "description": "NGINX Plus Prometheus Exporter",
+ "editable": true,
+ "fiscalYearStartMonth": 0,
+ "gnetId": 12930,
+ "graphTooltip": 0,
+ "id": 2,
+ "links": [],
+ "liveNow": false,
+ "panels": [
+ {
+ "collapsed": false,
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "gridPos": {
+ "h": 1,
+ "w": 24,
+ "x": 0,
+ "y": 0
+ },
+ "id": 6,
+ "panels": [],
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "refId": "A"
+ }
+ ],
+ "title": "Metrics",
+ "type": "row"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "description": "",
+ "fieldConfig": {
+ "defaults": {
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "green",
+ "value": null
+ }
+ ]
+ }
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 3,
+ "w": 6,
+ "x": 0,
+ "y": 1
+ },
+ "id": 27,
+ "options": {
+ "colorMode": "value",
+ "graphMode": "area",
+ "justifyMode": "auto",
+ "orientation": "auto",
+ "reduceOptions": {
+ "calcs": [
+ "lastNotNull"
+ ],
+ "fields": "",
+ "values": false
+ },
+ "textMode": "auto"
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "sum(increase(nginxplus_http_requests_total[1h]))",
+ "interval": "",
+ "legendFormat": "",
+ "refId": "A"
+ }
+ ],
+ "title": "Total requests in last hour",
+ "type": "stat"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "description": "",
+ "fieldConfig": {
+ "defaults": {
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "dark-blue",
+ "value": null
+ }
+ ]
+ }
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 3,
+ "w": 6,
+ "x": 6,
+ "y": 1
+ },
+ "id": 29,
+ "options": {
+ "colorMode": "value",
+ "graphMode": "area",
+ "justifyMode": "auto",
+ "orientation": "auto",
+ "reduceOptions": {
+ "calcs": [
+ "lastNotNull"
+ ],
+ "fields": "",
+ "values": false
+ },
+ "textMode": "auto"
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "sum(increase(nginxplus_upstream_server_responses{code=\"2xx\"}[1h]))",
+ "interval": "",
+ "legendFormat": "",
+ "refId": "A"
+ }
+ ],
+ "title": "Total (2XX from upstream) requests in last hour",
+ "type": "stat"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "description": "",
+ "fieldConfig": {
+ "defaults": {
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "orange",
+ "value": null
+ }
+ ]
+ }
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 3,
+ "w": 6,
+ "x": 12,
+ "y": 1
+ },
+ "id": 30,
+ "options": {
+ "colorMode": "value",
+ "graphMode": "area",
+ "justifyMode": "auto",
+ "orientation": "auto",
+ "reduceOptions": {
+ "calcs": [
+ "lastNotNull"
+ ],
+ "fields": "",
+ "values": false
+ },
+ "textMode": "auto"
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "sum(increase(nginxplus_upstream_server_responses{code=\"4xx\"}[1h]))",
+ "interval": "",
+ "legendFormat": "",
+ "refId": "A"
+ }
+ ],
+ "title": "Total (4XX from upstream) requests in last hour",
+ "type": "stat"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "description": "",
+ "fieldConfig": {
+ "defaults": {
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "red",
+ "value": null
+ }
+ ]
+ }
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 3,
+ "w": 6,
+ "x": 18,
+ "y": 1
+ },
+ "id": 28,
+ "options": {
+ "colorMode": "value",
+ "graphMode": "area",
+ "justifyMode": "auto",
+ "orientation": "auto",
+ "reduceOptions": {
+ "calcs": [
+ "lastNotNull"
+ ],
+ "fields": "",
+ "values": false
+ },
+ "textMode": "auto"
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "sum(increase(nginxplus_upstream_server_responses{code=\"5xx\"}[1h]))",
+ "interval": "",
+ "legendFormat": "",
+ "refId": "A"
+ }
+ ],
+ "title": "Total (5XX from upstream) requests in last hour",
+ "type": "stat"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "fieldConfig": {
+ "defaults": {
+ "color": {
+ "mode": "palette-classic"
+ },
+ "custom": {
+ "axisCenteredZero": false,
+ "axisColorMode": "text",
+ "axisLabel": "requests (rate)",
+ "axisPlacement": "auto",
+ "barAlignment": 0,
+ "drawStyle": "line",
+ "fillOpacity": 10,
+ "gradientMode": "none",
+ "hideFrom": {
+ "legend": false,
+ "tooltip": false,
+ "viz": false
+ },
+ "lineInterpolation": "linear",
+ "lineWidth": 1,
+ "pointSize": 5,
+ "scaleDistribution": {
+ "type": "linear"
+ },
+ "showPoints": "never",
+ "spanNulls": false,
+ "stacking": {
+ "group": "A",
+ "mode": "none"
+ },
+ "thresholdsStyle": {
+ "mode": "off"
+ }
+ },
+ "links": [],
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "green",
+ "value": null
+ },
+ {
+ "color": "red",
+ "value": 80
+ }
+ ]
+ },
+ "unit": "short"
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 13,
+ "w": 12,
+ "x": 0,
+ "y": 4
+ },
+ "id": 15,
+ "links": [],
+ "options": {
+ "legend": {
+ "calcs": [],
+ "displayMode": "list",
+ "placement": "bottom",
+ "showLegend": true
+ },
+ "tooltip": {
+ "mode": "multi",
+ "sort": "none"
+ }
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "editorMode": "code",
+ "expr": "irate(nginxplus_http_requests_total{instance=~\"$instance\"}[5m])",
+ "format": "time_series",
+ "hide": false,
+ "instant": false,
+ "interval": "",
+ "intervalFactor": 1,
+ "legendFormat": "{{instance}}",
+ "refId": "A"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "sum (irate(nginxplus_http_requests_total{instance=~\"$instance\"}[5m]))",
+ "hide": false,
+ "interval": "",
+ "intervalFactor": 1,
+ "legendFormat": "Total",
+ "refId": "B"
+ }
+ ],
+ "title": "Total Requests",
+ "type": "timeseries"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "description": "",
+ "fieldConfig": {
+ "defaults": {
+ "color": {
+ "mode": "palette-classic"
+ },
+ "custom": {
+ "axisCenteredZero": false,
+ "axisColorMode": "text",
+ "axisLabel": "",
+ "axisPlacement": "auto",
+ "barAlignment": 0,
+ "drawStyle": "line",
+ "fillOpacity": 10,
+ "gradientMode": "none",
+ "hideFrom": {
+ "legend": false,
+ "tooltip": false,
+ "viz": false
+ },
+ "lineInterpolation": "linear",
+ "lineWidth": 1,
+ "pointSize": 5,
+ "scaleDistribution": {
+ "type": "linear"
+ },
+ "showPoints": "never",
+ "spanNulls": false,
+ "stacking": {
+ "group": "A",
+ "mode": "none"
+ },
+ "thresholdsStyle": {
+ "mode": "off"
+ }
+ },
+ "links": [],
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "green",
+ "value": null
+ },
+ {
+ "color": "red",
+ "value": 80
+ }
+ ]
+ },
+ "unit": "ms"
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 13,
+ "w": 12,
+ "x": 12,
+ "y": 4
+ },
+ "id": 20,
+ "options": {
+ "legend": {
+ "calcs": [],
+ "displayMode": "list",
+ "placement": "bottom",
+ "showLegend": true
+ },
+ "tooltip": {
+ "mode": "multi",
+ "sort": "asc"
+ }
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "editorMode": "code",
+ "exemplar": false,
+ "expr": "irate(nginxplus_upstream_server_response_time{instance=~\"$instance\"}[$__interval])",
+ "hide": false,
+ "instant": false,
+ "interval": "",
+ "legendFormat": "{{ instance }}",
+ "range": true,
+ "refId": "A"
+ }
+ ],
+ "title": "LB Server Resp Time",
+ "type": "timeseries"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "description": "",
+ "fieldConfig": {
+ "defaults": {
+ "color": {
+ "mode": "palette-classic"
+ },
+ "custom": {
+ "axisCenteredZero": false,
+ "axisColorMode": "text",
+ "axisLabel": "requests (rate)",
+ "axisPlacement": "auto",
+ "barAlignment": 0,
+ "drawStyle": "line",
+ "fillOpacity": 10,
+ "gradientMode": "none",
+ "hideFrom": {
+ "legend": false,
+ "tooltip": false,
+ "viz": false
+ },
+ "lineInterpolation": "linear",
+ "lineWidth": 1,
+ "pointSize": 5,
+ "scaleDistribution": {
+ "type": "linear"
+ },
+ "showPoints": "never",
+ "spanNulls": false,
+ "stacking": {
+ "group": "A",
+ "mode": "none"
+ },
+ "thresholdsStyle": {
+ "mode": "off"
+ }
+ },
+ "links": [],
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "green",
+ "value": null
+ },
+ {
+ "color": "red",
+ "value": 80
+ }
+ ]
+ },
+ "unit": "short"
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 14,
+ "w": 12,
+ "x": 0,
+ "y": 17
+ },
+ "id": 31,
+ "links": [],
+ "options": {
+ "legend": {
+ "calcs": [],
+ "displayMode": "list",
+ "placement": "bottom",
+ "showLegend": true
+ },
+ "tooltip": {
+ "mode": "multi",
+ "sort": "none"
+ }
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "editorMode": "code",
+ "expr": "irate(nginxplus_upstream_server_requests{instance=~\"$instance\"}[$__interval])",
+ "format": "time_series",
+ "hide": false,
+ "instant": false,
+ "interval": "",
+ "intervalFactor": 1,
+ "legendFormat": "{{ upstream }} - {{ server }}",
+ "refId": "A"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "editorMode": "code",
+ "expr": "sum (irate(nginxplus_upstream_server_requests{instance=~\"$instance\"}[$__interval]))",
+ "hide": true,
+ "interval": "",
+ "intervalFactor": 1,
+ "legendFormat": "Total",
+ "range": true,
+ "refId": "B"
+ }
+ ],
+ "title": "LB Upstream Requests",
+ "type": "timeseries"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "description": "",
+ "fieldConfig": {
+ "defaults": {
+ "color": {
+ "mode": "palette-classic"
+ },
+ "custom": {
+ "axisCenteredZero": false,
+ "axisColorMode": "text",
+ "axisLabel": "",
+ "axisPlacement": "auto",
+ "barAlignment": 0,
+ "drawStyle": "line",
+ "fillOpacity": 10,
+ "gradientMode": "none",
+ "hideFrom": {
+ "legend": false,
+ "tooltip": false,
+ "viz": false
+ },
+ "lineInterpolation": "linear",
+ "lineWidth": 1,
+ "pointSize": 5,
+ "scaleDistribution": {
+ "type": "linear"
+ },
+ "showPoints": "never",
+ "spanNulls": false,
+ "stacking": {
+ "group": "A",
+ "mode": "none"
+ },
+ "thresholdsStyle": {
+ "mode": "off"
+ }
+ },
+ "links": [],
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "green",
+ "value": null
+ },
+ {
+ "color": "red",
+ "value": 80
+ }
+ ]
+ },
+ "unit": "ms"
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 14,
+ "w": 12,
+ "x": 12,
+ "y": 17
+ },
+ "id": 25,
+ "options": {
+ "legend": {
+ "calcs": [],
+ "displayMode": "list",
+ "placement": "bottom",
+ "showLegend": true
+ },
+ "tooltip": {
+ "mode": "multi",
+ "sort": "none"
+ }
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "editorMode": "code",
+ "expr": "avg by (server) (nginxplus_upstream_server_response_time)",
+ "hide": true,
+ "interval": "",
+ "legendFormat": "{{ server }}",
+ "range": true,
+ "refId": "A"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "editorMode": "code",
+ "expr": "irate(nginxplus_upstream_server_response_time{instance=~\"$instance\"}[$__interval])",
+ "hide": false,
+ "interval": "",
+ "legendFormat": "{{ server }}",
+ "range": true,
+ "refId": "B"
+ }
+ ],
+ "title": "LB Upstream Resp Time",
+ "type": "timeseries"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "description": "",
+ "fieldConfig": {
+ "defaults": {
+ "color": {
+ "mode": "palette-classic"
+ },
+ "custom": {
+ "axisCenteredZero": false,
+ "axisColorMode": "text",
+ "axisLabel": "Connections (rate)",
+ "axisPlacement": "auto",
+ "barAlignment": 0,
+ "drawStyle": "line",
+ "fillOpacity": 10,
+ "gradientMode": "none",
+ "hideFrom": {
+ "legend": false,
+ "tooltip": false,
+ "viz": false
+ },
+ "lineInterpolation": "linear",
+ "lineWidth": 1,
+ "pointSize": 5,
+ "scaleDistribution": {
+ "type": "linear"
+ },
+ "showPoints": "never",
+ "spanNulls": false,
+ "stacking": {
+ "group": "A",
+ "mode": "none"
+ },
+ "thresholdsStyle": {
+ "mode": "off"
+ }
+ },
+ "decimals": 1,
+ "links": [],
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "green",
+ "value": null
+ },
+ {
+ "color": "red",
+ "value": 80
+ }
+ ]
+ },
+ "unit": "short"
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 9,
+ "w": 12,
+ "x": 0,
+ "y": 31
+ },
+ "id": 10,
+ "links": [],
+ "options": {
+ "legend": {
+ "calcs": [],
+ "displayMode": "list",
+ "placement": "bottom",
+ "showLegend": true
+ },
+ "tooltip": {
+ "mode": "multi",
+ "sort": "none"
+ }
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "irate(nginxplus_connections_accepted{instance=~\"$instance\"}[5m])",
+ "format": "time_series",
+ "instant": false,
+ "interval": "",
+ "intervalFactor": 1,
+ "legendFormat": "{{instance}} accepted",
+ "refId": "A"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "sum(irate(nginxplus_connections_accepted[5m]))",
+ "interval": "",
+ "legendFormat": "Total",
+ "refId": "B"
+ }
+ ],
+ "title": "Processed connections",
+ "type": "timeseries"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "fieldConfig": {
+ "defaults": {
+ "color": {
+ "mode": "palette-classic"
+ },
+ "custom": {
+ "axisCenteredZero": false,
+ "axisColorMode": "text",
+ "axisLabel": "Connections",
+ "axisPlacement": "auto",
+ "barAlignment": 0,
+ "drawStyle": "line",
+ "fillOpacity": 10,
+ "gradientMode": "none",
+ "hideFrom": {
+ "legend": false,
+ "tooltip": false,
+ "viz": false
+ },
+ "lineInterpolation": "linear",
+ "lineWidth": 1,
+ "pointSize": 5,
+ "scaleDistribution": {
+ "type": "linear"
+ },
+ "showPoints": "never",
+ "spanNulls": false,
+ "stacking": {
+ "group": "A",
+ "mode": "none"
+ },
+ "thresholdsStyle": {
+ "mode": "off"
+ }
+ },
+ "decimals": 0,
+ "links": [],
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "green",
+ "value": null
+ },
+ {
+ "color": "red",
+ "value": 80
+ }
+ ]
+ },
+ "unit": "short"
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 9,
+ "w": 12,
+ "x": 12,
+ "y": 31
+ },
+ "id": 12,
+ "links": [],
+ "options": {
+ "legend": {
+ "calcs": [],
+ "displayMode": "list",
+ "placement": "bottom",
+ "showLegend": true
+ },
+ "tooltip": {
+ "mode": "multi",
+ "sort": "none"
+ }
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "nginxplus_connections_active{instance=~\"$instance\"}",
+ "format": "time_series",
+ "interval": "",
+ "intervalFactor": 1,
+ "legendFormat": "{{instance}}",
+ "refId": "A"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "sum(nginxplus_connections_active)",
+ "interval": "",
+ "legendFormat": "Total",
+ "refId": "B"
+ }
+ ],
+ "title": "Active Connections",
+ "type": "timeseries"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "fieldConfig": {
+ "defaults": {
+ "color": {
+ "mode": "palette-classic"
+ },
+ "custom": {
+ "axisCenteredZero": false,
+ "axisColorMode": "text",
+ "axisLabel": "",
+ "axisPlacement": "auto",
+ "barAlignment": 0,
+ "drawStyle": "line",
+ "fillOpacity": 10,
+ "gradientMode": "none",
+ "hideFrom": {
+ "legend": false,
+ "tooltip": false,
+ "viz": false
+ },
+ "lineInterpolation": "linear",
+ "lineWidth": 1,
+ "pointSize": 5,
+ "scaleDistribution": {
+ "type": "linear"
+ },
+ "showPoints": "never",
+ "spanNulls": false,
+ "stacking": {
+ "group": "A",
+ "mode": "none"
+ },
+ "thresholdsStyle": {
+ "mode": "off"
+ }
+ },
+ "links": [],
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "green",
+ "value": null
+ },
+ {
+ "color": "red",
+ "value": 80
+ }
+ ]
+ },
+ "unit": "short"
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 8,
+ "w": 24,
+ "x": 0,
+ "y": 40
+ },
+ "id": 22,
+ "options": {
+ "legend": {
+ "calcs": [],
+ "displayMode": "list",
+ "placement": "bottom",
+ "showLegend": true
+ },
+ "tooltip": {
+ "mode": "multi",
+ "sort": "none"
+ }
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "sum by (upstream ) (irate(nginxplus_upstream_server_responses{code=\"2xx\"}[5m]))",
+ "interval": "",
+ "legendFormat": "{{ upstream }}",
+ "refId": "A"
+ }
+ ],
+ "title": "2XX status code (rate over 5m)",
+ "type": "timeseries"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "description": "",
+ "fieldConfig": {
+ "defaults": {
+ "color": {
+ "mode": "palette-classic"
+ },
+ "custom": {
+ "axisCenteredZero": false,
+ "axisColorMode": "text",
+ "axisLabel": "",
+ "axisPlacement": "auto",
+ "barAlignment": 0,
+ "drawStyle": "line",
+ "fillOpacity": 10,
+ "gradientMode": "none",
+ "hideFrom": {
+ "legend": false,
+ "tooltip": false,
+ "viz": false
+ },
+ "lineInterpolation": "linear",
+ "lineWidth": 1,
+ "pointSize": 5,
+ "scaleDistribution": {
+ "type": "linear"
+ },
+ "showPoints": "never",
+ "spanNulls": false,
+ "stacking": {
+ "group": "A",
+ "mode": "none"
+ },
+ "thresholdsStyle": {
+ "mode": "off"
+ }
+ },
+ "links": [],
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "green",
+ "value": null
+ },
+ {
+ "color": "red",
+ "value": 80
+ }
+ ]
+ },
+ "unit": "short"
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 8,
+ "w": 12,
+ "x": 0,
+ "y": 48
+ },
+ "id": 24,
+ "options": {
+ "legend": {
+ "calcs": [],
+ "displayMode": "list",
+ "placement": "bottom",
+ "showLegend": true
+ },
+ "tooltip": {
+ "mode": "multi",
+ "sort": "none"
+ }
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "sum by (upstream ) (irate(nginxplus_upstream_server_responses{code=\"4xx\"}[5m]))",
+ "interval": "",
+ "legendFormat": "{{ upstream }}",
+ "refId": "A"
+ }
+ ],
+ "title": "4XX status code (rate over 5m)",
+ "type": "timeseries"
+ },
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "fieldConfig": {
+ "defaults": {
+ "color": {
+ "mode": "palette-classic"
+ },
+ "custom": {
+ "axisCenteredZero": false,
+ "axisColorMode": "text",
+ "axisLabel": "",
+ "axisPlacement": "auto",
+ "barAlignment": 0,
+ "drawStyle": "line",
+ "fillOpacity": 10,
+ "gradientMode": "none",
+ "hideFrom": {
+ "legend": false,
+ "tooltip": false,
+ "viz": false
+ },
+ "lineInterpolation": "linear",
+ "lineWidth": 1,
+ "pointSize": 5,
+ "scaleDistribution": {
+ "type": "linear"
+ },
+ "showPoints": "never",
+ "spanNulls": false,
+ "stacking": {
+ "group": "A",
+ "mode": "none"
+ },
+ "thresholdsStyle": {
+ "mode": "off"
+ }
+ },
+ "links": [],
+ "mappings": [],
+ "thresholds": {
+ "mode": "absolute",
+ "steps": [
+ {
+ "color": "green",
+ "value": null
+ },
+ {
+ "color": "red",
+ "value": 80
+ }
+ ]
+ },
+ "unit": "short"
+ },
+ "overrides": []
+ },
+ "gridPos": {
+ "h": 8,
+ "w": 12,
+ "x": 12,
+ "y": 48
+ },
+ "id": 23,
+ "options": {
+ "legend": {
+ "calcs": [],
+ "displayMode": "list",
+ "placement": "bottom",
+ "showLegend": true
+ },
+ "tooltip": {
+ "mode": "multi",
+ "sort": "none"
+ }
+ },
+ "pluginVersion": "9.4.7",
+ "targets": [
+ {
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "expr": "sum by (upstream ) (irate(nginxplus_upstream_server_responses{code=\"5xx\"}[5m]))",
+ "interval": "",
+ "legendFormat": "{{ upstream }}",
+ "refId": "A"
+ }
+ ],
+ "title": "5XX status code (rate over 5m)",
+ "type": "timeseries"
+ }
+ ],
+ "refresh": "5s",
+ "revision": 1,
+ "schemaVersion": 38,
+ "style": "dark",
+ "tags": [
+ "nginx"
+ ],
+ "templating": {
+ "list": [
+ {
+ "current": {
+ "selected": true,
+ "text": [
+ "10.1.1.4:80"
+ ],
+ "value": [
+ "10.1.1.4:80"
+ ]
+ },
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "definition": "label_values(up, instance)",
+ "hide": 0,
+ "includeAll": true,
+ "label": "",
+ "multi": true,
+ "name": "instance",
+ "options": [],
+ "query": {
+ "query": "label_values(up, instance)",
+ "refId": "StandardVariableQuery"
+ },
+ "refresh": 1,
+ "regex": "",
+ "skipUrlSync": false,
+ "sort": 0,
+ "tagValuesQuery": "",
+ "tagsQuery": "",
+ "type": "query",
+ "useTags": false
+ },
+ {
+ "current": {
+ "selected": true,
+ "text": [
+ "All"
+ ],
+ "value": [
+ "$__all"
+ ]
+ },
+ "datasource": {
+ "type": "prometheus",
+ "uid": "EszmC2Y4z"
+ },
+ "definition": "label_values(upstream)",
+ "hide": 0,
+ "includeAll": true,
+ "label": "",
+ "multi": true,
+ "name": "upstream",
+ "options": [],
+ "query": {
+ "query": "label_values(upstream)",
+ "refId": "StandardVariableQuery"
+ },
+ "refresh": 1,
+ "regex": "",
+ "skipUrlSync": false,
+ "sort": 1,
+ "tagValuesQuery": "",
+ "tagsQuery": "",
+ "type": "query",
+ "useTags": false
+ }
+ ]
+ },
+ "time": {
+ "from": "now-5m",
+ "to": "now"
+ },
+ "timepicker": {
+ "hidden": false,
+ "refresh_intervals": [
+ "5s",
+ "10s",
+ "30s",
+ "1m",
+ "5m",
+ "15m",
+ "30m",
+ "1h",
+ "2h",
+ "1d"
+ ],
+ "time_options": [
+ "5m",
+ "15m",
+ "1h",
+ "6h",
+ "12h",
+ "24h",
+ "2d",
+ "7d",
+ "30d"
+ ]
+ },
+ "timezone": "",
+ "title": "NGINX K8s LB",
+ "uid": "L4nOehY4k",
+ "version": 7,
+ "weekStart": ""
+ }
+
\ No newline at end of file
diff --git a/docs/http/nginx.conf b/docs/http/nginx.conf
new file mode 100644
index 0000000..6a97691
--- /dev/null
+++ b/docs/http/nginx.conf
@@ -0,0 +1,47 @@
+user nginx;
+worker_processes auto;
+
+error_log /var/log/nginx/error.log notice;
+pid /var/run/nginx.pid;
+
+load_module modules/ngx_http_js_module.so;
+
+worker_rlimit_nofile 2048;
+
+events {
+ worker_connections 2048;
+}
+
+
+http {
+ include /etc/nginx/mime.types;
+ default_type application/octet-stream;
+
+ log_format main '$remote_addr - $upstream_addr - $upstream_status - $remote_user [$time_local] $host - "$request" '
+ '$status $body_bytes_sent "$http_referer" '
+ '"$http_user_agent" "$http_x_forwarded_for"';
+
+ access_log /var/log/nginx/access.log main;
+
+ sendfile on;
+ #tcp_nopush on;
+
+ keepalive_timeout 65;
+
+ #gzip on;
+
+ include /etc/nginx/conf.d/*.conf;
+
+ #added for Prometheus
+ subrequest_output_buffer_size 32k;
+
+}
+
+
+# TCP load balancing block
+#
+stream {
+ include /etc/nginx/stream/*.conf;
+ log_format stream '$remote_addr - $server_addr [$time_local] $status $upstream_addr $upstream_bytes_sent';
+ access_log /var/log/nginx/stream.log stream;
+}
diff --git a/docs/http/prometheus.conf b/docs/http/prometheus.conf
new file mode 100644
index 0000000..97fc124
--- /dev/null
+++ b/docs/http/prometheus.conf
@@ -0,0 +1,18 @@
+# NginxK8sLB Prometheus configuration, for HTTP scraper page
+# Chris Akker, Apr 2023
+# https://www.nginx.com/blog/how-to-visualize-nginx-plus-with-prometheus-and-grafana/
+#
+#### prometheus.conf
+
+js_import /usr/share/nginx-plus-module-prometheus/prometheus.js;
+
+server {
+ location = /metrics {
+ js_content prometheus.metrics;
+ }
+
+ location /api {
+ api;
+ }
+
+}
diff --git a/docs/http/prometheus.yml b/docs/http/prometheus.yml
new file mode 100644
index 0000000..c8b19cb
--- /dev/null
+++ b/docs/http/prometheus.yml
@@ -0,0 +1,14 @@
+global:
+ scrape_interval: 15s
+
+ external_labels:
+ monitor: 'codelab-monitor'
+
+scrape_configs:
+ - job_name: 'prometheus'
+
+ scrape_interval: 5s
+
+ static_configs:
+ - targets: ['10.1.1.4:80', '10.1.1.5:80']
+
\ No newline at end of file
diff --git a/docs/http/zonesync.conf b/docs/http/zonesync.conf
new file mode 100644
index 0000000..b11ed73
--- /dev/null
+++ b/docs/http/zonesync.conf
@@ -0,0 +1,19 @@
+# NginxK8sLB Zone Sync configuration, for KVstore split
+# Chris Akker, Apr 2023
+# Stream Zone Sync block
+# 2 Nginx Plus nodes KVstore zone
+# Nginx Kubernetes Loadbalancer
+# https://docs.nginx.com/nginx/admin-guide/high-availability/zone_sync/
+#
+#### zonesync.conf
+
+server {
+ zone_sync;
+
+ listen 9001;
+
+ # cluster of 2 nodes
+ zone_sync_server 10.1.1.4:9001;
+ zone_sync_server 10.1.1.5:9001;
+
+ }
diff --git a/docs/media/cafe-dashboard.png b/docs/media/cafe-dashboard.png
new file mode 100644
index 0000000000000000000000000000000000000000..c5cf9029ee6a703dd0972a6fc72ab9692e9d6e1f
GIT binary patch
literal 200082
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