gdbmongo
GDB pretty printers and commands for debugging the MongoDB Server
Decision gist · record as of 2026-08-14
Yes, if you are debugging MongoDB Server internals or analyzing MongoDB core dumps. The package is low-friction to install, has no runtime dependencies, and is actively maintained for recent MongoDB versions. No, if you are not working on MongoDB Server itself or do not have access to GDB with Python support in your environment.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- GDB must be linked against the same Python installation where gdbmongo is installed; virtual environments do not work because GDB uses the base system libpython.
- Low install friction with no runtime dependencies.
- Maintenance is dormant but recent—last commit 2025-02-13—and the package is actively tested against current MongoDB versions.
License · maintenance · safety
Apache License, Version 2.0 (permissive) — Apache License 2.0 is permissive; you may use, modify, and distribute this package freely in commercial and private projects provided you include the license notice.
last release 2025-02-13 (547 days) · last repo commit 2025-02-13 · 23 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,736,963 downloads/mo, #3,605 on PyPI
Alternatives
Verify before relying
# Add to ~/.gdbinit:
python
import gdbmongo
gdbmongo.register_printers()
end
# In GDB:
(gdb) python lock_mgr = gdbmongo.LockManagerPrinter.from_global()
(gdb) python print(lock_mgr.val)- Whether the package works reliably against all advertised MongoDB versions or only those explicitly tested in recent releases.
- Performance impact of pretty printer registration on GDB startup time or responsiveness.
- Whether core dump analysis works across different architectures or only within the MongoDB toolchain environment.
What it is and what it does
Gdbmongo is a GDB extension that adds pretty printers and debugging commands specifically for MongoDB Server internals. It is designed primarily for MongoDB employees and contributors who need to inspect server state during development and troubleshooting. The package walks in-memory data structures rather than executing C++ code, which allows it to work against both live processes and saved core dumps—a critical capability for post-mortem analysis in CI/CD environments.
The package targets a moving target: instead of fragmenting tools across each MongoDB version branch, gdbmongo aims to be a single version that works across multiple supported MongoDB releases. It currently supports dumping the global LockManager, displaying thread names, inspecting CursorManager partitions, and decoding BSON objects. Installation requires manual setup in GDB's Python environment (not a virtual environment), and pretty printer collections can be selectively enabled or disabled within GDB.
Use it for
- Analyze MongoDB server core dumps in CI/CD pipelines to diagnose hangs, crashes, or resource contention without rebuilding the server.
- Inspect the global LockManager state in a running MongoDB process to understand lock holders and waiters during development.
- Decode BSON objects and thread metadata in core dumps to reconstruct server state at the time of failure.
- Debug MongoDB 4.2 through 8.1 binaries with a single tool version instead of maintaining branch-specific GDB extensions.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are debugging MongoDB Server internals or analyzing MongoDB core dumps.
The package is low-friction to install, has no runtime dependencies, and is actively maintained for recent MongoDB versions. No, if you are not working on MongoDB Server itself or do not have access to GDB with Python support in your environment.
Install
gdbmongo on PyPI
Before you install
Low install friction with no runtime dependencies. Maintenance is dormant but recent—last commit 2025-02-13—and the package is actively tested against current MongoDB versions. Installation requires manual setup in GDB's Python environment, not a standard virtual environment.
GDB must be linked against the same Python installation where gdbmongo is installed; virtual environments do not work because GDB uses the base system libpython.
License in practice
Apache License 2.0 is permissive; you may use, modify, and distribute this package freely in commercial and private projects provided you include the license notice.
Quickstart
# Add to ~/.gdbinit:
python
import gdbmongo
gdbmongo.register_printers()
end
# In GDB:
(gdb) python lock_mgr = gdbmongo.LockManagerPrinter.from_global()
(gdb) python print(lock_mgr.val)Verify before relying
- Whether the package works reliably against all advertised MongoDB versions or only those explicitly tested in recent releases.
- Performance impact of pretty printer registration on GDB startup time or responsiveness.
- Whether core dump analysis works across different architectures or only within the MongoDB toolchain environment.
Package facts
| License | Apache License, Version 2.0 permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 547 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,736,963 / month, #3,605 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseOperating System :: POSIXProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.9Topic :: DatabaseTopic :: Database :: Database Engines/ServersTopic :: Software Development :: Debuggers |
Evidence: gdbmongo-0.16.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “gdb mongodb debugging”
- gdbmongoGdbmongo provides GDB pretty printers and commands for inspecting…
- freertos-gdbA GDB Python plugin that adds commands to inspect and display…
- esp-idf-panic-decoderParses ESP-IDF panic handler output (registers and stack dumps) and…
Give your agent the search over MCP, or paste the wish link into any chat.
More Database packages
psycopg2-binary is a PostgreSQL database adapter for Python that implements the DB API 2.0 specification, enabling Python applications to connect to and query PostgreSQL databases with thread-safe concurrent operations.
Python client library for connecting to and executing commands against Redis key-value stores, supporting both synchronous and asynchronous operations.
Install it if your application needs to interact with Redis; the only prerequisite is a running Redis server instance.
YDB Python SDK is the official client library for connecting to and querying YDB databases from Python applications.
Install it if you need to connect Python applications to YDB databases.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
sqlparse tokenizes SQL text into a tree of statements, clauses, and expressions, and provides functions to split scripts, format queries, and inspect parsed tokens without validating dialect or syntax.
Install it if you need to manipulate, format, or analyze SQL text programmatically.
Provides base adapter protocols and shared functionality that database adapters use to integrate with dbt-core, handling connections, dialect translation, relation caching, and core interface management.
See also freertos-gdb · prettyprinter · pygdbmi · apache-airflow-providers-mongo · pymongo · curatorbin · pymongo_inmemory · pydantic-mongo · Flask-PyMongo · wadler-lindig