Agent skill · software engineering · jeremylongshore
glean-debug-bundle
Collect Glean diagnostic information for support including datasource
Why this skill is useful
Adds an executable script for collecting Glean diagnostic information that automates troubleshooting processes not covered in public documentation.
What it needs
Requires curl, jq, tar installed locally. Requires glean account access. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Glean Debug Bundle Overview This debug bundle collects diagnostic evidence from Glean enterprise search integrations for troubleshooting datasource configuration, document indexing pipelines, and search quality issues. It captures indexing token validation, datasource configuration state, crawl status, search query test results, and permission model health. The resulting tarball provides the evidence needed to diagnose connector failures, stale index problems, missing document results, and permission-based search gaps without requiring admin console access. Prerequisites curl, jq, tar installed GLEANDOMAIN set to your Glean instance (e.g., your-company-be.glean.com) GLEANINDEXINGTOKEN for datasource/indexing endpoints GLEANCLIENTTOKEN for search API endpoints Debug Collection Script Analyzing the Bundle Common Issues Symptom Check in Bundle Fix --------- ---------------- ----- 401 on indexing API environment.txt shows token NOT SET Generate new indexing token in Glean admin under Datasources > API Datasource config returns empty datasource-config.json has no fields Set GLEANDATASOURCE env var to match your registered datasource name Search returns 0 results search-test.json results array is empty Check indexing-status.json for crawl completion; new datasources take 15-60 min to index 403 on search endpoint search-test.json shows permission error Client token needs search scope; regenerate with correct permissions in admin Stale documents in results indexing-status.json shows old lastCrawlTime Trigger a re-crawl via admin UI or POST to /api/index/v1/bulkindexdocuments Rate limited during bulk indexing rate-limits.txt shows retry-after header Batch documents in groups of 100; respect 10 req/sec indexing limit Automated Health Check Instructions 1. Start with a synthetic probe and a bounded time window; collect status codes, timing bands, configuration revisions, and opaque correlation IDs only. 2. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/glean-debug-bundle