doc: point at wiki
This commit is contained in:
parent
b07bbea0aa
commit
2fa72b5cf4
74
README.md
74
README.md
@ -13,74 +13,8 @@ current hosting solution. Right now, my hosting is provided by GitHub pages and
|
|||||||
one did in th 2010s). But as we start to enforce more privacy rights through systems like GDPR, I find myself wanting a
|
one did in th 2010s). But as we start to enforce more privacy rights through systems like GDPR, I find myself wanting a
|
||||||
simpler solution that doesn't require cookie disclosures.
|
simpler solution that doesn't require cookie disclosures.
|
||||||
|
|
||||||
## Quickstart with Docker
|
## Resources
|
||||||
|
|
||||||
The easiest way to get started is with Docker. Your web content will be exposed on port `8080` while [metrics](#metrics)
|
- [Quickstart](https://github.com/mjpitz/pages/wiki#quickstart-with-docker)
|
||||||
will be available on `8081`.
|
- [Metrics](https://github.com/mjpitz/pages/wiki/Metrics)
|
||||||
|
- [Deployment](https://github.com/mjpitz/pages/wiki/Deployment)
|
||||||
```shell
|
|
||||||
docker run --rm -it \
|
|
||||||
-e PAGES_GIT_URL=<your repo> \
|
|
||||||
-e PAGES_GIT_BRANCH=gh-pages \
|
|
||||||
-p 8080:8080 \
|
|
||||||
-p 8081:8081 \
|
|
||||||
img.pitz.tech/mya/pages
|
|
||||||
```
|
|
||||||
|
|
||||||
**Syncing the git repository**
|
|
||||||
|
|
||||||
You can instruct the server to reload the Git branch by curling this `/_admin/sync` endpoint.
|
|
||||||
|
|
||||||
```shell
|
|
||||||
curl -X POST http://localhost:8080/_admin/sync
|
|
||||||
```
|
|
||||||
|
|
||||||
This endpoint is exposed publicly so your CI solution can issue the command to cause the servers to update.
|
|
||||||
|
|
||||||
## Metrics
|
|
||||||
|
|
||||||
All metrics are prefixed with the `pages` namespace. This makes it easy to narrow down to the specific metrics for the
|
|
||||||
system.
|
|
||||||
|
|
||||||
### pages_page_view_count
|
|
||||||
|
|
||||||
The number of page views for a given path and their associated referrer.
|
|
||||||
|
|
||||||
```text
|
|
||||||
# HELP pages_page_view_count the number of times a given page has been viewed and by what referrer
|
|
||||||
# TYPE pages_page_view_count counter
|
|
||||||
pages_page_view_count{country="",path="/charts/",referrer="http://localhost:8080/blog/"} 1
|
|
||||||
```
|
|
||||||
|
|
||||||
### pages_page_session_seconds
|
|
||||||
|
|
||||||
Histogram of how long users spend on a page.
|
|
||||||
|
|
||||||
```text
|
|
||||||
# HELP pages_page_session_seconds how long someone spent on a given page
|
|
||||||
# TYPE pages_page_session_seconds histogram
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="0.005"} 0
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="0.01"} 0
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="0.025"} 0
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="0.05"} 0
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="0.1"} 0
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="0.25"} 0
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="0.5"} 0
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="1"} 0
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="2.5"} 1
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="5"} 1
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="10"} 1
|
|
||||||
pages_page_session_seconds_bucket{country="",path="/",le="+Inf"} 1
|
|
||||||
pages_page_session_seconds_sum{country="",path="/"} 1.855976549
|
|
||||||
pages_page_session_seconds_count{country="",path="/"} 1
|
|
||||||
```
|
|
||||||
|
|
||||||
### pages_page_sessions_active
|
|
||||||
|
|
||||||
A gauge that approximates the current number of sessions per page.
|
|
||||||
|
|
||||||
```text
|
|
||||||
# HELP pages_page_sessions_active the number of current sessions for a given page
|
|
||||||
# TYPE pages_page_sessions_active gauge
|
|
||||||
pages_page_sessions_active{country="",path="/"} 1
|
|
||||||
```
|
|
||||||
|
Loading…
Reference in New Issue
Block a user