asgi-matomo 0.1.0

Middleware for tracking ASGI reqeusts with Matomo

asgi-matomo

Tracking requests with Matomo from ASGI apps.

MatomoMiddleware adds tracking of all requests to Matomo to ASGI applications (Starlette, FastAPI, Quart, etc.).

Installation

pip install asgi-matomo

Examples

Starlette

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
from starlette.middleware import Middleware

from asgi_matomo import MatomoMiddleware

async def homepage(request):
    return JSONResponse({"data": "a" * 4000})

app = Starlette(
  routes=[Route("/", homepage)],
  middleware=[
    Middleware(
      MatomoMiddleware,
      matomo_url="YOUR MATOMO TRACKING URL",
      idsite=12345, # your service tracking id
  )],
)

FastAPI

from fastapi import FastAPI
from asgi_matomo import MatomoMiddleware

app = FastAPI()
app.add_middleware(
  BrotliMiddleware,
  matomo_url="YOUR MATOMO TRACKING URL",
  idsite=12345, # your service tracking id
)

@app.get("/")
def home() -> dict:
    return {"data": "a" * 4000}

API Reference

Overview

app.add_middleware(
  MatomoMiddleware,
  matomo_url="YOUR MATOMO TRACKING URL",
  idsite=12345, # your service tracking id
  access_token="SECRETTOKEN",
  assume_https=True,
  minimum_size=400,
)

Parameters:

• (Required) matomo_url: The URL to make your tracking calls to.
• (Required) idsite: The tracking id for your service.
• (Optional) access_token: Access token for Matomo. If this is set cip is also tracked. Required for tracking some data.
• (Optional) assume_https: If True, set tracked url scheme to https, useful when running behind a proxy. Defaults to True.

Notes:

• Currently only some parts Matomo Tracking HTTP API is supported.

Ideas for further work:

• filtering tracked of urls
• custom extraction of tracked data

Release Notes

Latest Changes

0.1.0 - 2023-04-28

• Initial release.