Jump to content

Wikidata Platform

From Wikitech

Technical documentation for the Wikidata Platform, including the Wikidata Query Service (WDQS).

See mediawiki.org for additional technical documentation and the official team page. User docs for WDQS are at wikidata:SPARQL query service.

Components

Production

Experiments, testing, analytics

Query data

See Wikidata_Platform/Query_Data for tables you can use to analyze WDQS requests.

Monitoring, SLO

Runbooks

These runbooks are intended for WDP engineers:

SREs also maintain various runbooks for WDQS alerts that might be of interest for WDP engineers as well.

Alerts w/ config links and their corresponding runbooks
AlertRunbook
BlazegraphFailedClientRatioIncreaseWikidata_Query_Service/Runbook#Increased_ratio_of_failed_requests_(4xx)
BlazegraphFailedServerRatioIncreaseWikidata_Query_Service/Runbook/High_replication_lag_and_query_timeout
BlazegraphFreeAllocatorsDecreasingRapidly, BlazegraphFreeAllocatorsRunningOutWikidata_Query_Service/Runbook#Free_allocators_decrease_rapidly
BlazegraphMainTriplesDeltaIncreasing, BlazegraphCategoryTriplesDeltaIncreasingWikidata_Query_Service/Runbook#Incomplete/problematic_data_reload
CategoriesQueryServiceUpdateLagTooHighWikidata_Query_Service/Runbook#Categories_update_lag
ElevatedMaxLagWDQSWikidata_Query_Service/Runbook#Timeouts and Wikidata_Query_Service/Runbook/High_replication_lag_and_query_timeout
RdfStreamingUpdaterFlinkJobUnstableWikidata_Query_Service/Streaming_Updater#The_job_is_not_starting
RdfStreamingUpdaterFlinkProcessingLatencyIsHighWikidata_Query_Service/Streaming_Updater#The_job_processing_latency_is_high
RdfStreamingUpdaterHighConsumerUpdateLagWikidata_Query_Service/Streaming_Updater#The_consumers_are_backlogged
WdqsStreamingUpdaterFlinkJobNotRunningWikidata_Query_Service/Streaming_Updater#The_job_is_not_running