Content that doesn't show up correctly in search or list pages
The Elasticsearch cluster utilised by Search API can get out of sync with publishing applications. This affects any part of the site using it, including navigation pages and related links.
Root cause
For Whitehall document formats (i.e. those that have not been migrated to the new index), Search API depends on requests from whitehall admin to stay up to date. This is a “fire and forget” task that doesn’t block the user’s publishing action, and if anything goes wrong, the search data will stay unchanged until the next time an update is made to the document.
See search-api ADR 004 for details of how we improved this for non-whitehall formats.
Check if search is the problem
A page with URL /council-tax can be queried using /api/search.json?filter_link=/council-tax. You can quickly switch between the two using the GOV.UK browser extension.
You can compare the data returned with the publishing app to check if it’s up to date. An empty response means search has never received the content.
You can also request different fields, for example /api/search.json?filter_link=/council-tax&fields=format,content_id.
If the document is missing from the search API, check the search index itself to see if it is present and has the expected fields:
Create a tunnel to Elasticsearch:
ssh -At jumpbox.staging.govuk.digital -L 9200:localhost:9200 "ssh -q \`govuk_node_list --single-node -c search\` -L 9200:elasticsearch6.blue.staging.govuk-internal.digital:80"Send a
POSTrequest tohttp://localhost:9200/govuk/_search:{ "filter": { "term": { "link": "/the/path/to/the/page" } } }Or search by content ID:
{ "filter": { "term": { "content_id": "638db33a-fe73-45fd-96e2-7dcf8281ff16" } } }
If the document is present and looks correct, it suggests that the problem is
that the document does not match the search query. You can debug the query by
adding the parameter debug=show_query to the search API URL, e.g.
https://www.gov.uk/api/search.json?q=badgers&debug=show_query.
Correct the search data
Most search issues can be fixed by either republishing the content, or manually reindexing via a rake task in the publishing app.
Published content is missing from search/finders/navigation
Try republishing the content.
Unpublished content is still showing up in search
Unpublished content can be removed from search manually using search admin.
There are blank options on finder pages
See the instructions for fixing blank finder filter options.