mya/pages
1
Fork 0
Code Issues 5 Pull Requests Projects Releases Wiki Activity

doc: point at wiki

Browse Source
This commit is contained in:
Mya 2022-06-09 11:59:43 -05:00
parent b07bbea0aa
commit 2fa72b5cf4
No known key found for this signature in database
GPG Key ID: C3ECFA648DAD27FA
1 changed files with 4 additions and 70 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

74
README.md
View File

@ -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
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)
will be available on `8081`.
```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
```
- [Quickstart](https://github.com/mjpitz/pages/wiki#quickstart-with-docker)
- [Metrics](https://github.com/mjpitz/pages/wiki/Metrics)
- [Deployment](https://github.com/mjpitz/pages/wiki/Deployment)