Help:CirrusSearch elasticsearch replicas: Difference between revisions
Revision as of 17:02, 3 September 2019 (view source)
Ebernhardson (talk | contribs)
← Older edit
Revision as of 17:09, 3 September 2019 (view source)
Ebernhardson (talk | contribs)
(→‎Accessing)
Newer edit →
Line 2:Line 2:


=== Accessing ====== Accessing ===
There are actually three clusters, named ''chi'', ''psi'' and ''omega''. ''chi'' contains approximately the 200 largest wikis. ''psi'' and ''omega'' contain equal splits of the remaining smaller wikis.There are actually three clusters, named ''chi'', ''psi'' and ''omega''. ''chi'' contains approximately the 200 largest wikis. ''psi'' and ''omega'' contain equal splits of the remaining smaller wikis. Assignment of wikis to clusters is constant and is not expected to change.

{|{|
|-|-
Line 22:Line 21:


<code>curl -XGET http<nowiki>s</nowiki>://cloudelastic.wikimedia.org:8243/omega:labswiki/_search?q=example</code><code>curl -XGET http<nowiki>s</nowiki>://cloudelastic.wikimedia.org:8243/omega:labswiki/_search?q=example</code>

A plausible method to programatically connect to the right cluster is to fetch the <code>/_aliases</code> end-point from each cluster. The cluster that contains indices for a wiki will have an alias matching the internal database name of the wiki. This alias will point to all related indices, such as ''labswiki_content'' and ''labswiki_general''.


=== Indices Available ====== Indices Available ===
Revision as of 17:09, 3 September 2019
Cloud Elastic is a replica of the CirrusSearch elasticsearch indices made available to Wikimedia Cloud Services applications (both Cloud VPS and Toolforge). These servers are not generally accessible from the internet at large, rather they are only accessible through applications running inside Cloud Services. Applications can use the full power of the elasticsearch search API's to query the search indices in ways that CirrusSearch does not expose directly on the wiki's themselves.
Contents
1Accessing
2Indices Available
3Schema
4Example Use Cases
4.1Query all indices
4.2Query all content indices
4.3Fetch full document for single page by page id
4.4Fetch full document for single page by title
Accessing
There are actually three clusters, named chi, psi and omega. chi contains approximately the 200 largest wikis. psi and omega contain equal splits of the remaining smaller wikis. Assignment of wikis to clusters is constant and is not expected to change.
Cluster NameURL
chihttps://cloudelastic.wikimedia.org:8243/
psihttps://cloudelastic.wikimedia.org:8643/
omegahttps://cloudelastic.wikimedia.org:8443/
Clusters can be accessed through each other using the elasticsearch cross cluster search syntax. For example labswiki (wikitech's internal database name), which lives on the omega cluster, can be queried through the chi cluster with:
curl -XGET https://cloudelastic.wikimedia.org:8243/omega:labswiki/_search?q=example
A plausible method to programatically connect to the right cluster is to fetch the /_aliases end-point from each cluster. The cluster that contains indices for a wiki will have an alias matching the internal database name of the wiki. This alias will point to all related indices, such as labswiki_content and labswiki_general​.
Indices Available
All wikis have two indices, of the format <dbname>_content and <dbname>_general​. The content index contains all of the content namespaces of the wiki, the general index contains everything else. So for example on wikipedia's articles are found in the content index, and talk pages are found in the general index. Querying both indices can be done through an alias by providing only the wiki db name.
The set of indices that exist in a cluster can be queried through the elasticsearch cat indices API.
curl -XGET https://cloudelastic.wikimedia.org:9843/_cat/indices
Schema
See mw:Extension:CirrusSearch/Schema​.
Example Use Cases
Query all indices
curl -XGET https://cloudelastic.wikimedia.org:8243/*,*:*/_search?q=example
Query all content indices
curl -XGET https://cloudelastic.wikimedia.org:8243/*_content,*:*_content/_search?q=example
Fetch full document for single page by page id
curl -XGET https://cloudelastic.wikimedia.org:8243/enwiki_content/page/33179123
Fetch full document for single page by title
curl -XGET https://cloudelastic.wikimedia.org:8243/enwiki_content/_search?q=title.keyword:Elasticsearch
Search
This page was last edited on 3 September 2019, at 17:09.
Text is available under the Creative Commons Attribution-ShareAlike License; additional terms may apply. See Terms of Use for details.
Privacy policy
About Wikitech
Disclaimers
Code of Conduct
Mobile view
Developers
Statistics
Cookie statement
Create accountLog in
Help pageDiscussion
ReadView sourceView history
Visit the main pageMain pageRecent changesServer admin log: ProdAdmin log: RelEngIncident statusDeploymentsSRE Team HelpCloud VPS portalToolforge portalRequest VPS projectAdmin log: Cloud VPSWhat links hereRelated changesSpecial pagesPermanent linkPage informationCite this pageCreate a bookDownload as PDFPrintable version