Upgrade python3-prometheus-client to v0.22.0

Author: gizmoguy

.circleci/config.yml

@@ -75,11 +75,11 @@ workflows:
           matrix:
             parameters:
                python:
-                 - "3.8.18"
                  - "3.9.18"
                  - "3.10"
                  - "3.11"
                  - "3.12"
+                 - "3.13"
       - test_nooptionals:
           matrix:
             parameters:
@@ -89,4 +89,4 @@ workflows:
           matrix:
             parameters:
                python:
-                 - "3.8"
+                 - "3.9"

MANIFEST.in

@@ -1 +1 @@
-.hugo_build.lock
+.hugo_build.lock

docs/.gitignore

@@ -1,37 +1,32 @@
-Docs
-----
+# Docs
 
 This directory contains [hugo](https://gohugo.io) documentation to be published in Github pages.
 
-Run Locally
------------
+## Dependencies
 
-```
+- [Geekdocs v1.5.0](https://github.com/thegeeklab/hugo-geekdoc/releases/tag/v1.5.0)
+- [Hugo v0.145.0](https://github.com/gohugoio/hugo/releases/tag/v0.145.0)
+
+## Run Locally
+
+To serve the documentation locally, run the following command:
+
+```shell
 hugo server -D
 ```
 
 This will serve the docs on [http://localhost:1313](http://localhost:1313).
 
-Deploy to Github Pages
-----------------------
-
-Changes to the `main` branch will be deployed automatically with Github actions.
-
-Update Geekdocs
----------------
+## Update Geekdocs
 
 The docs use the [Geekdocs](https://geekdocs.de/) theme. The theme is checked in to Github in the `./docs/themes/hugo-geekdoc/` folder. To update [Geekdocs](https://geekdocs.de/), remove the current folder and create a new one with the latest [release](https://github.com/thegeeklab/hugo-geekdoc/releases). There are no local modifications in `./docs/themes/hugo-geekdoc/`.
 
-Notes
------
-
-Here's how the initial `docs/` folder was set up:
-
-```
-hugo new site docs
-cd docs/
+```shell
+rm -rf ./docs/themes/hugo-geekdoc
 mkdir -p themes/hugo-geekdoc/
-curl -L https://github.com/thegeeklab/hugo-geekdoc/releases/download/v0.41.1/hugo-geekdoc.tar.gz | tar -xz -C themes/hugo-geekdoc/ --strip-components=1
+curl -L https://github.com/thegeeklab/hugo-geekdoc/releases/latest/download/hugo-geekdoc.tar.gz | tar -xz -C themes/hugo-geekdoc/ --strip-components=1
 ```
 
-Create the initial `hugo.toml` file as described in [https://geekdocs.de/usage/getting-started/](https://geekdocs.de/usage/getting-started/).
+## Deploy to Github Pages
+
+Changes to the `master` branch will be deployed automatically with Github actions.

docs/README.md

@@ -1,5 +1,49 @@
 ---
-title: "client_python"
+title: client_python
+weight: 1
 ---
 
-This is the documentation for the [Prometheus Python client library](https://github.com/prometheus/client_python).
+This tutorial shows the quickest way to get started with the Prometheus Python library.
+
+**One**: Install the client:
+
+```shell
+pip install prometheus-client
+```
+
+**Two**: Paste the following into a Python interpreter:
+
+```python
+from prometheus_client import start_http_server, Summary
+import random
+import time
+
+# Create a metric to track time spent and requests made.
+REQUEST_TIME = Summary('request_processing_seconds', 'Time spent processing request')
+
+# Decorate function with metric.
+@REQUEST_TIME.time()
+def process_request(t):
+    """A dummy function that takes some time."""
+    time.sleep(t)
+
+if __name__ == '__main__':
+    # Start up the server to expose the metrics.
+    start_http_server(8000)
+    # Generate some requests.
+    while True:
+        process_request(random.random())
+```
+
+**Three**: Visit [http://localhost:8000/](http://localhost:8000/) to view the metrics.
+
+From one easy to use decorator you get:
+
+* `request_processing_seconds_count`: Number of times this function was called.
+* `request_processing_seconds_sum`: Total amount of time spent in this function.
+
+Prometheus's `rate` function allows calculation of both requests per second,
+and latency over time from this data.
+
+In addition if you're on Linux the `process` metrics expose CPU, memory and
+other information about the process for free!

docs/content/_index.md

@@ -5,6 +5,9 @@ weight: 3
 
 The [Pushgateway](https://github.com/prometheus/pushgateway)
 allows ephemeral and batch jobs to expose their metrics to Prometheus.
+Since Prometheus may not be able to scrape such a target, the targets can
+push their metrics to a separate instance of the Pushgateway,
+which then exposes these metrics to Prometheus.
 
 ```python
 from prometheus_client import CollectorRegistry, Gauge, push_to_gateway
@@ -18,16 +21,20 @@ push_to_gateway('localhost:9091', job='batchA', registry=registry)
 A separate registry is used, as the default registry may contain other metrics
 such as those from the Process Collector.
 
-Pushgateway functions take a grouping key. `push_to_gateway` replaces metrics
-with the same grouping key, `pushadd_to_gateway` only replaces metrics with the
-same name and grouping key and `delete_from_gateway` deletes metrics with the
-given job and grouping key. See the
+Pushgateway functions take a grouping key.
+1. `push_to_gateway` replaces metrics
+with the same grouping key.
+2. `pushadd_to_gateway` only replaces metrics with the
+same name and grouping key.
+3. `delete_from_gateway` deletes metrics with the
+given job and grouping key.
+4. `instance_ip_grouping_key` returns a grouping key with the instance label set
+to the host's IP address.
+
+See the
 [Pushgateway documentation](https://github.com/prometheus/pushgateway/blob/master/README.md)
 for more information.
 
-`instance_ip_grouping_key` returns a grouping key with the instance label set
-to the host's IP address.
-
 # Handlers for authentication
 
 If the push gateway you are connecting to is protected with HTTP Basic Auth,

docs/content/exporting/pushgateway.md

@@ -14,6 +14,7 @@ This comes with a number of limitations:
   - Registering metrics to a registry later used by a `MultiProcessCollector`
     may cause duplicate metrics to be exported
 - Custom collectors do not work (e.g. cpu and memory metrics)
+- Gauges cannot use `set_function`
 - Info and Enum metrics do not work
 - The pushgateway cannot be used
 - Gauges cannot use the `pid` label

docs/content/getting-started/_index.md

@@ -5,20 +5,19 @@ theme = "hugo-geekdoc"
 
 pluralizeListTitles = false
 
-# Geekdoc required configuration
-#pygmentsUseClasses = true
-pygmentsUseClasses = false
+# Required to get well formatted code blocks
+pygmentsUseClasses = true
 pygmentsCodeFences = true
 disablePathToLower = true
-# geekdocFileTreeSortBy = "linkTitle"
+enableGitInfo = true
 
 # Required if you want to render robots.txt template
 enableRobotsTXT = true
 
-# Needed for mermaid shortcodes
 [markup]
   [markup.goldmark.renderer]
-    # Needed for mermaid shortcode
+    # Needed for mermaid shortcode or when nesting shortcodes (e.g. img within
+    # columns or tabs)
     unsafe = true
   [markup.tableOfContents]
     startLevel = 1
@@ -28,3 +27,93 @@ enableRobotsTXT = true
 
 [taxonomies]
    tag = "tags"
+
+[params]
+# (Optional, default 6) Set how many table of contents levels to be showed on page.
+# Use false to hide ToC, note that 0 will default to 6 (https://gohugo.io/functions/default/)
+# You can also specify this parameter per page in front matter.
+geekdocToC = 3
+
+# (Optional, default static/brand.svg) Set the path to a logo for the Geekdoc
+# relative to your 'static/' folder.
+geekdocLogo = "brand.svg"
+
+# (Optional, default false) Render menu from data file in 'data/menu/main.yaml'.
+# See also https://geekdocs.de/usage/menus/#bundle-menu.
+geekdocMenuBundle = false
+
+# (Optional, default false) Collapse all menu entries, can not be overwritten
+# per page if enabled. Can be enabled per page via 'geekdocCollapseSection'.
+geekdocCollapseAllSections = false
+
+# (Optional, default true) Show page navigation links at the bottom of each docs page.
+geekdocNextPrev = true
+
+# (Optional, default true) Show a breadcrumb navigation bar at the top of each docs page.
+# You can also specify this parameter per page in front matter.
+geekdocBreadcrumb = true
+
+# (Optional, default none) Set source repository location. Used for 'Edit page' links.
+# You can also specify this parameter per page in front matter.
+geekdocRepo = "https://github.com/prometheus/client_python"
+
+# (Optional, default none) Enable 'Edit page' links. Requires 'geekdocRepo' param
+# and the path must point to the parent directory of the 'content' folder.
+# You can also specify this parameter per page in front matter.
+geekdocEditPath = "edit/master/docs"
+
+# (Optional, default false) Show last modification date of the page in the header.
+# Keep in mind that last modification date works best if `enableGitInfo` is set to true.
+geekdocPageLastmod = true
+
+# (Optional, default true) Enables search function with flexsearch.
+# Index is built on the fly and might slow down your website.
+geekdocSearch = true
+
+# (Optional, default false) Display search results with the parent folder as prefix. This
+# option allows you to distinguish between files with the same name in different folders.
+# NOTE: This parameter only applies when 'geekdocSearch = true'.
+geekdocSearchShowParent = true
+
+# (Optional, default true) Add an anchor link to headlines.
+geekdocAnchor = true
+
+# (Optional, default true) Copy anchor url to clipboard on click.
+geekdocAnchorCopy = true
+
+# (Optional, default true) Enable or disable image lazy loading for images rendered
+# by the 'img' shortcode.
+geekdocImageLazyLoading = true
+
+# (Optional, default false) Set HTMl <base> to .Site.Home.Permalink if enabled. It might be required
+# if a subdirectory is used within Hugos BaseURL.
+# See https://developer.mozilla.org/de/docs/Web/HTML/Element/base.
+geekdocOverwriteHTMLBase = false
+
+# (Optional, default true) Enable or disable the JavaScript based color theme toggle switch. The CSS based
+# user preference mode still works.
+geekdocDarkModeToggle = true
+
+# (Optional, default false) Auto-decrease brightness of images and add a slightly grayscale to avoid
+# bright spots while using the dark mode.
+geekdocDarkModeDim = false
+
+# (Optional, default false) Enforce code blocks to always use the dark color theme.
+geekdocDarkModeCode = false
+
+# (Optional, default true) Display a "Back to top" link in the site footer.
+geekdocBackToTop = true
+
+# (Optional, default false) Enable or disable adding tags for post pages automatically to the navigation sidebar.
+geekdocTagsToMenu = true
+
+# (Optional, default 'title') Configure how to sort file-tree menu entries. Possible options are 'title', 'linktitle',
+# 'date', 'publishdate', 'expirydate' or 'lastmod'. Every option can be used with a reverse modifier as well
+# e.g. 'title_reverse'.
+geekdocFileTreeSortBy = "title"
+
+# (Optional, default none) Adds a "Content licensed under <license>" line to the footer.
+# Could be used if you want to define a default license for your content.
+[params.geekdocContentLicense]
+  name = "Apache License 2.0"
+  link = "https://github.com/prometheus/client_python/blob/master/LICENSE"