SLO/AQS/Geo Analytics

Status: draft

Organizational

Service

This page provides information on the publicly accessible Geo analytics service, which is hosted at the base path: https://wikimedia.org/api/rest_v1/metrics/editors/by-country

In order to make a service call, it is necessary to append appropriate request parameters to the following URL: https://wikimedia.org/api/rest_v1/metrics/editors/by-country/{project}/{activity-level}/{year}/{month}

For example:

https://wikimedia.org/api/rest_v1/metrics/editors/by-country/en.wikipedia/5..99-edits/2020/12

Teams

The Data products team is the service owner of the geo analytics service.

Architectural

Environmental dependencies

The Geo Analytics service runs on kubernetes, proxied through the rest gateway. It is available in both the eqiad and codfw data centers.

Service dependencies

Beyond the environmental dependencies above, its storage backend is Cassandra, used as a datastore.

Client-facing

Clients

Community Members:

Seeing impact in terms of Wikipedia project and the upper bound of their editor counts

Identifying growth opportunities

WMF Staff:

Movement health and impact metrics

Geographic equity

Audience reach

Editor acquisition

Essential and Core Metrics

WMF Engineers and other Technical Contributors :

Provide them with accessible APIs that allow them to reliably accomplish their engineering and analytics tasks that make use of AQS endpoints in a self-serve and efficient way.

Request Classes

Requests are classified by HTTP method and by the API endpoint:

GET https://wikimedia.org/api/rest_v1/metrics/editors/by-country/en.wikipedia/5..99-edits/2020/12

Service Level Indicators (SLIs)

Uptime (availability) percentage: The percentage of all requests receiving a non-error response, defined as one of: HTTP 200 (success).

Latency: percentage of requests that are completed within a certain deadline,

Service Level Objectives

TBD