@neverinfamous/postgres-mcp 2.0.0 → 2.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.md +119 -46
- package/dist/__tests__/benchmarks/codemode.bench.js +3 -3
- package/dist/__tests__/benchmarks/codemode.bench.js.map +1 -1
- package/dist/__tests__/benchmarks/connection-pool.bench.js +3 -3
- package/dist/__tests__/benchmarks/connection-pool.bench.js.map +1 -1
- package/dist/__tests__/benchmarks/introspection-migration.bench.d.ts +11 -0
- package/dist/__tests__/benchmarks/introspection-migration.bench.d.ts.map +1 -0
- package/dist/__tests__/benchmarks/introspection-migration.bench.js +143 -0
- package/dist/__tests__/benchmarks/introspection-migration.bench.js.map +1 -0
- package/dist/__tests__/benchmarks/resource-prompts.bench.js +0 -64
- package/dist/__tests__/benchmarks/resource-prompts.bench.js.map +1 -1
- package/dist/__tests__/benchmarks/schema-parsing.bench.js +5 -5
- package/dist/__tests__/benchmarks/schema-parsing.bench.js.map +1 -1
- package/dist/__tests__/benchmarks/tool-filtering.bench.js +17 -8
- package/dist/__tests__/benchmarks/tool-filtering.bench.js.map +1 -1
- package/dist/__tests__/mocks/adapter.d.ts.map +1 -1
- package/dist/__tests__/mocks/adapter.js +2 -1
- package/dist/__tests__/mocks/adapter.js.map +1 -1
- package/dist/adapters/DatabaseAdapter.d.ts +6 -5
- package/dist/adapters/DatabaseAdapter.d.ts.map +1 -1
- package/dist/adapters/DatabaseAdapter.js +11 -20
- package/dist/adapters/DatabaseAdapter.js.map +1 -1
- package/dist/adapters/postgresql/PostgresAdapter.d.ts +5 -26
- package/dist/adapters/postgresql/PostgresAdapter.d.ts.map +1 -1
- package/dist/adapters/postgresql/PostgresAdapter.js +31 -526
- package/dist/adapters/postgresql/PostgresAdapter.js.map +1 -1
- package/dist/adapters/postgresql/prompts/index.js +1 -1
- package/dist/adapters/postgresql/prompts/index.js.map +1 -1
- package/dist/adapters/postgresql/resources/index.d.ts +1 -1
- package/dist/adapters/postgresql/resources/index.js +3 -3
- package/dist/adapters/postgresql/resources/index.js.map +1 -1
- package/dist/adapters/postgresql/schema-operations.d.ts +71 -0
- package/dist/adapters/postgresql/schema-operations.d.ts.map +1 -0
- package/dist/adapters/postgresql/schema-operations.js +561 -0
- package/dist/adapters/postgresql/schema-operations.js.map +1 -0
- package/dist/adapters/postgresql/schemas/admin.d.ts +4 -4
- package/dist/adapters/postgresql/schemas/admin.js +4 -4
- package/dist/adapters/postgresql/schemas/admin.js.map +1 -1
- package/dist/adapters/postgresql/schemas/backup.d.ts +2 -2
- package/dist/adapters/postgresql/schemas/backup.d.ts.map +1 -1
- package/dist/adapters/postgresql/schemas/backup.js +1 -3
- package/dist/adapters/postgresql/schemas/backup.js.map +1 -1
- package/dist/adapters/postgresql/schemas/core/index.d.ts +6 -0
- package/dist/adapters/postgresql/schemas/core/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/core/index.js +6 -0
- package/dist/adapters/postgresql/schemas/core/index.js.map +1 -0
- package/dist/adapters/postgresql/schemas/{core.d.ts → core/queries.d.ts} +16 -171
- package/dist/adapters/postgresql/schemas/core/queries.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/{core.js → core/queries.js} +5 -213
- package/dist/adapters/postgresql/schemas/core/queries.js.map +1 -0
- package/dist/adapters/postgresql/schemas/core/transactions.d.ts +149 -0
- package/dist/adapters/postgresql/schemas/core/transactions.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/core/transactions.js +239 -0
- package/dist/adapters/postgresql/schemas/core/transactions.js.map +1 -0
- package/dist/adapters/postgresql/schemas/cron.d.ts +12 -12
- package/dist/adapters/postgresql/schemas/cron.d.ts.map +1 -1
- package/dist/adapters/postgresql/schemas/cron.js +38 -10
- package/dist/adapters/postgresql/schemas/cron.js.map +1 -1
- package/dist/adapters/postgresql/schemas/extensions/citext.d.ts +222 -0
- package/dist/adapters/postgresql/schemas/extensions/citext.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/citext.js +306 -0
- package/dist/adapters/postgresql/schemas/extensions/citext.js.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/index.d.ts +15 -0
- package/dist/adapters/postgresql/schemas/extensions/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/index.js +20 -0
- package/dist/adapters/postgresql/schemas/extensions/index.js.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/kcache.d.ts +164 -0
- package/dist/adapters/postgresql/schemas/extensions/kcache.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/kcache.js +225 -0
- package/dist/adapters/postgresql/schemas/extensions/kcache.js.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/ltree.d.ts +253 -0
- package/dist/adapters/postgresql/schemas/extensions/ltree.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/ltree.js +430 -0
- package/dist/adapters/postgresql/schemas/extensions/ltree.js.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/pgcrypto.d.ts +251 -0
- package/dist/adapters/postgresql/schemas/extensions/pgcrypto.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/pgcrypto.js +294 -0
- package/dist/adapters/postgresql/schemas/extensions/pgcrypto.js.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/shared.d.ts +10 -0
- package/dist/adapters/postgresql/schemas/extensions/shared.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/extensions/shared.js +15 -0
- package/dist/adapters/postgresql/schemas/extensions/shared.js.map +1 -0
- package/dist/adapters/postgresql/schemas/index.d.ts +6 -6
- package/dist/adapters/postgresql/schemas/index.d.ts.map +1 -1
- package/dist/adapters/postgresql/schemas/index.js +8 -8
- package/dist/adapters/postgresql/schemas/index.js.map +1 -1
- package/dist/adapters/postgresql/schemas/introspection.d.ts +19 -42
- package/dist/adapters/postgresql/schemas/introspection.d.ts.map +1 -1
- package/dist/adapters/postgresql/schemas/introspection.js +72 -27
- package/dist/adapters/postgresql/schemas/introspection.js.map +1 -1
- package/dist/adapters/postgresql/schemas/jsonb/advanced.d.ts +270 -0
- package/dist/adapters/postgresql/schemas/jsonb/advanced.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/jsonb/advanced.js +371 -0
- package/dist/adapters/postgresql/schemas/jsonb/advanced.js.map +1 -0
- package/dist/adapters/postgresql/schemas/jsonb/basic.d.ts +283 -0
- package/dist/adapters/postgresql/schemas/jsonb/basic.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/jsonb/basic.js +456 -0
- package/dist/adapters/postgresql/schemas/jsonb/basic.js.map +1 -0
- package/dist/adapters/postgresql/schemas/jsonb/index.d.ts +6 -0
- package/dist/adapters/postgresql/schemas/jsonb/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/jsonb/index.js +6 -0
- package/dist/adapters/postgresql/schemas/jsonb/index.js.map +1 -0
- package/dist/adapters/postgresql/schemas/monitoring.d.ts +4 -4
- package/dist/adapters/postgresql/schemas/monitoring.js +2 -2
- package/dist/adapters/postgresql/schemas/monitoring.js.map +1 -1
- package/dist/adapters/postgresql/schemas/partitioning.d.ts +14 -14
- package/dist/adapters/postgresql/schemas/partitioning.d.ts.map +1 -1
- package/dist/adapters/postgresql/schemas/partitioning.js +64 -46
- package/dist/adapters/postgresql/schemas/partitioning.js.map +1 -1
- package/dist/adapters/postgresql/schemas/partman.d.ts +16 -14
- package/dist/adapters/postgresql/schemas/partman.d.ts.map +1 -1
- package/dist/adapters/postgresql/schemas/partman.js +9 -9
- package/dist/adapters/postgresql/schemas/partman.js.map +1 -1
- package/dist/adapters/postgresql/schemas/postgis/advanced.d.ts +429 -0
- package/dist/adapters/postgresql/schemas/postgis/advanced.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/postgis/advanced.js +495 -0
- package/dist/adapters/postgresql/schemas/postgis/advanced.js.map +1 -0
- package/dist/adapters/postgresql/schemas/{postgis.d.ts → postgis/basic.d.ts} +1 -423
- package/dist/adapters/postgresql/schemas/postgis/basic.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/{postgis.js → postgis/basic.js} +1 -486
- package/dist/adapters/postgresql/schemas/postgis/basic.js.map +1 -0
- package/dist/adapters/postgresql/schemas/postgis/index.d.ts +6 -0
- package/dist/adapters/postgresql/schemas/postgis/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/postgis/index.js +6 -0
- package/dist/adapters/postgresql/schemas/postgis/index.js.map +1 -0
- package/dist/adapters/postgresql/schemas/schema-mgmt.d.ts +35 -25
- package/dist/adapters/postgresql/schemas/schema-mgmt.d.ts.map +1 -1
- package/dist/adapters/postgresql/schemas/schema-mgmt.js +57 -19
- package/dist/adapters/postgresql/schemas/schema-mgmt.js.map +1 -1
- package/dist/adapters/postgresql/schemas/stats/index.d.ts +6 -0
- package/dist/adapters/postgresql/schemas/stats/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/stats/index.js +6 -0
- package/dist/adapters/postgresql/schemas/stats/index.js.map +1 -0
- package/dist/adapters/postgresql/schemas/stats/input.d.ts +260 -0
- package/dist/adapters/postgresql/schemas/stats/input.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/{stats.js → stats/input.js} +2 -331
- package/dist/adapters/postgresql/schemas/stats/input.js.map +1 -0
- package/dist/adapters/postgresql/schemas/{stats.d.ts → stats/output.d.ts} +3 -246
- package/dist/adapters/postgresql/schemas/stats/output.d.ts.map +1 -0
- package/dist/adapters/postgresql/schemas/stats/output.js +334 -0
- package/dist/adapters/postgresql/schemas/stats/output.js.map +1 -0
- package/dist/adapters/postgresql/schemas/text-search.d.ts +18 -18
- package/dist/adapters/postgresql/schemas/text-search.d.ts.map +1 -1
- package/dist/adapters/postgresql/schemas/text-search.js +12 -27
- package/dist/adapters/postgresql/schemas/text-search.js.map +1 -1
- package/dist/adapters/postgresql/schemas/vector.d.ts +10 -10
- package/dist/adapters/postgresql/schemas/vector.d.ts.map +1 -1
- package/dist/adapters/postgresql/schemas/vector.js +9 -15
- package/dist/adapters/postgresql/schemas/vector.js.map +1 -1
- package/dist/adapters/postgresql/tools/backup/dump.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/backup/dump.js +95 -76
- package/dist/adapters/postgresql/tools/backup/dump.js.map +1 -1
- package/dist/adapters/postgresql/tools/backup/planning.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/backup/planning.js +345 -287
- package/dist/adapters/postgresql/tools/backup/planning.js.map +1 -1
- package/dist/adapters/postgresql/tools/citext/analysis.d.ts +24 -0
- package/dist/adapters/postgresql/tools/citext/analysis.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/{citext.js → citext/analysis.js} +50 -232
- package/dist/adapters/postgresql/tools/citext/analysis.js.map +1 -0
- package/dist/adapters/postgresql/tools/citext/index.d.ts +15 -0
- package/dist/adapters/postgresql/tools/citext/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/citext/index.js +23 -0
- package/dist/adapters/postgresql/tools/citext/index.js.map +1 -0
- package/dist/adapters/postgresql/tools/citext/setup.d.ts +16 -0
- package/dist/adapters/postgresql/tools/citext/setup.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/citext/setup.js +193 -0
- package/dist/adapters/postgresql/tools/citext/setup.js.map +1 -0
- package/dist/adapters/postgresql/tools/codemode/index.js +1 -1
- package/dist/adapters/postgresql/tools/codemode/index.js.map +1 -1
- package/dist/adapters/postgresql/tools/core/convenience.d.ts +12 -22
- package/dist/adapters/postgresql/tools/core/convenience.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/core/convenience.js +100 -210
- package/dist/adapters/postgresql/tools/core/convenience.js.map +1 -1
- package/dist/adapters/postgresql/tools/core/error-helpers.d.ts +1 -0
- package/dist/adapters/postgresql/tools/core/error-helpers.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/core/error-helpers.js +8 -1
- package/dist/adapters/postgresql/tools/core/error-helpers.js.map +1 -1
- package/dist/adapters/postgresql/tools/core/health.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/core/health.js +124 -114
- package/dist/adapters/postgresql/tools/core/health.js.map +1 -1
- package/dist/adapters/postgresql/tools/core/index.d.ts +2 -1
- package/dist/adapters/postgresql/tools/core/index.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/core/index.js +3 -2
- package/dist/adapters/postgresql/tools/core/index.js.map +1 -1
- package/dist/adapters/postgresql/tools/core/indexes.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/core/indexes.js +151 -127
- package/dist/adapters/postgresql/tools/core/indexes.js.map +1 -1
- package/dist/adapters/postgresql/tools/core/objects.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/core/objects.js +186 -161
- package/dist/adapters/postgresql/tools/core/objects.js.map +1 -1
- package/dist/adapters/postgresql/tools/core/query.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/core/query.js +37 -25
- package/dist/adapters/postgresql/tools/core/query.js.map +1 -1
- package/dist/adapters/postgresql/tools/core/schemas.d.ts +6 -3
- package/dist/adapters/postgresql/tools/core/schemas.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/core/schemas.js +11 -2
- package/dist/adapters/postgresql/tools/core/schemas.js.map +1 -1
- package/dist/adapters/postgresql/tools/core/tables.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/core/tables.js +156 -129
- package/dist/adapters/postgresql/tools/core/tables.js.map +1 -1
- package/dist/adapters/postgresql/tools/core/utility.d.ts +26 -0
- package/dist/adapters/postgresql/tools/core/utility.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/core/utility.js +174 -0
- package/dist/adapters/postgresql/tools/core/utility.js.map +1 -0
- package/dist/adapters/postgresql/tools/cron.js +90 -43
- package/dist/adapters/postgresql/tools/cron.js.map +1 -1
- package/dist/adapters/postgresql/tools/introspection/analysis.d.ts +12 -0
- package/dist/adapters/postgresql/tools/introspection/analysis.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/introspection/analysis.js +605 -0
- package/dist/adapters/postgresql/tools/introspection/analysis.js.map +1 -0
- package/dist/adapters/postgresql/tools/introspection/graph.d.ts +55 -0
- package/dist/adapters/postgresql/tools/introspection/graph.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/introspection/graph.js +621 -0
- package/dist/adapters/postgresql/tools/introspection/graph.js.map +1 -0
- package/dist/adapters/postgresql/tools/introspection/index.d.ts +21 -0
- package/dist/adapters/postgresql/tools/introspection/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/introspection/index.js +31 -0
- package/dist/adapters/postgresql/tools/introspection/index.js.map +1 -0
- package/dist/adapters/postgresql/tools/introspection/migration.d.ts +15 -0
- package/dist/adapters/postgresql/tools/introspection/migration.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/introspection/migration.js +575 -0
- package/dist/adapters/postgresql/tools/introspection/migration.js.map +1 -0
- package/dist/adapters/postgresql/tools/jsonb/analytics.d.ts +20 -0
- package/dist/adapters/postgresql/tools/jsonb/analytics.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/jsonb/analytics.js +367 -0
- package/dist/adapters/postgresql/tools/jsonb/analytics.js.map +1 -0
- package/dist/adapters/postgresql/tools/jsonb/index.d.ts +4 -2
- package/dist/adapters/postgresql/tools/jsonb/index.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/jsonb/index.js +8 -4
- package/dist/adapters/postgresql/tools/jsonb/index.js.map +1 -1
- package/dist/adapters/postgresql/tools/jsonb/read.d.ts +38 -0
- package/dist/adapters/postgresql/tools/jsonb/read.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/jsonb/{basic.js → read.js} +41 -482
- package/dist/adapters/postgresql/tools/jsonb/read.js.map +1 -0
- package/dist/adapters/postgresql/tools/jsonb/{advanced.d.ts → transform.d.ts} +1 -13
- package/dist/adapters/postgresql/tools/jsonb/transform.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/jsonb/{advanced.js → transform.js} +26 -357
- package/dist/adapters/postgresql/tools/jsonb/transform.js.map +1 -0
- package/dist/adapters/postgresql/tools/jsonb/write.d.ts +14 -0
- package/dist/adapters/postgresql/tools/jsonb/write.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/jsonb/write.js +468 -0
- package/dist/adapters/postgresql/tools/jsonb/write.js.map +1 -0
- package/dist/adapters/postgresql/tools/kcache.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/kcache.js +116 -51
- package/dist/adapters/postgresql/tools/kcache.js.map +1 -1
- package/dist/adapters/postgresql/tools/ltree.js +346 -260
- package/dist/adapters/postgresql/tools/ltree.js.map +1 -1
- package/dist/adapters/postgresql/tools/migration/index.d.ts +15 -0
- package/dist/adapters/postgresql/tools/migration/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/migration/index.js +23 -0
- package/dist/adapters/postgresql/tools/migration/index.js.map +1 -0
- package/dist/adapters/postgresql/tools/monitoring/analysis.d.ts +15 -0
- package/dist/adapters/postgresql/tools/monitoring/analysis.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/{monitoring.js → monitoring/analysis.js} +24 -359
- package/dist/adapters/postgresql/tools/monitoring/analysis.js.map +1 -0
- package/dist/adapters/postgresql/tools/monitoring/basic.d.ts +17 -0
- package/dist/adapters/postgresql/tools/monitoring/basic.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/monitoring/basic.js +432 -0
- package/dist/adapters/postgresql/tools/monitoring/basic.js.map +1 -0
- package/dist/adapters/postgresql/tools/monitoring/index.d.ts +16 -0
- package/dist/adapters/postgresql/tools/monitoring/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/monitoring/index.js +31 -0
- package/dist/adapters/postgresql/tools/monitoring/index.js.map +1 -0
- package/dist/adapters/postgresql/tools/partitioning/index.d.ts +15 -0
- package/dist/adapters/postgresql/tools/partitioning/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/partitioning/index.js +23 -0
- package/dist/adapters/postgresql/tools/partitioning/index.js.map +1 -0
- package/dist/adapters/postgresql/tools/partitioning/info.d.ts +11 -0
- package/dist/adapters/postgresql/tools/partitioning/info.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/partitioning/info.js +302 -0
- package/dist/adapters/postgresql/tools/partitioning/info.js.map +1 -0
- package/dist/adapters/postgresql/tools/partitioning/management.d.ts +28 -0
- package/dist/adapters/postgresql/tools/partitioning/management.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/{partitioning.js → partitioning/management.js} +48 -307
- package/dist/adapters/postgresql/tools/partitioning/management.js.map +1 -0
- package/dist/adapters/postgresql/tools/partman/helpers.d.ts +29 -0
- package/dist/adapters/postgresql/tools/partman/helpers.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/partman/helpers.js +59 -0
- package/dist/adapters/postgresql/tools/partman/helpers.js.map +1 -0
- package/dist/adapters/postgresql/tools/partman/index.d.ts +2 -1
- package/dist/adapters/postgresql/tools/partman/index.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/partman/index.js +4 -2
- package/dist/adapters/postgresql/tools/partman/index.js.map +1 -1
- package/dist/adapters/postgresql/tools/partman/maintenance.d.ts +20 -0
- package/dist/adapters/postgresql/tools/partman/maintenance.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/partman/maintenance.js +496 -0
- package/dist/adapters/postgresql/tools/partman/maintenance.js.map +1 -0
- package/dist/adapters/postgresql/tools/partman/management.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/partman/management.js +438 -383
- package/dist/adapters/postgresql/tools/partman/management.js.map +1 -1
- package/dist/adapters/postgresql/tools/partman/operations.d.ts +1 -13
- package/dist/adapters/postgresql/tools/partman/operations.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/partman/operations.js +171 -652
- package/dist/adapters/postgresql/tools/partman/operations.js.map +1 -1
- package/dist/adapters/postgresql/tools/performance/analysis.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/performance/analysis.js +69 -42
- package/dist/adapters/postgresql/tools/performance/analysis.js.map +1 -1
- package/dist/adapters/postgresql/tools/performance/anomaly-detection.d.ts +18 -0
- package/dist/adapters/postgresql/tools/performance/anomaly-detection.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/performance/anomaly-detection.js +533 -0
- package/dist/adapters/postgresql/tools/performance/anomaly-detection.js.map +1 -0
- package/dist/adapters/postgresql/tools/performance/diagnostics.d.ts +11 -0
- package/dist/adapters/postgresql/tools/performance/diagnostics.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/performance/diagnostics.js +332 -0
- package/dist/adapters/postgresql/tools/performance/diagnostics.js.map +1 -0
- package/dist/adapters/postgresql/tools/performance/index.d.ts +1 -1
- package/dist/adapters/postgresql/tools/performance/index.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/performance/index.js +7 -1
- package/dist/adapters/postgresql/tools/performance/index.js.map +1 -1
- package/dist/adapters/postgresql/tools/performance/monitoring.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/performance/monitoring.js +80 -55
- package/dist/adapters/postgresql/tools/performance/monitoring.js.map +1 -1
- package/dist/adapters/postgresql/tools/performance/optimization.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/performance/optimization.js +18 -11
- package/dist/adapters/postgresql/tools/performance/optimization.js.map +1 -1
- package/dist/adapters/postgresql/tools/performance/stats.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/performance/stats.js +439 -318
- package/dist/adapters/postgresql/tools/performance/stats.js.map +1 -1
- package/dist/adapters/postgresql/tools/pgcrypto.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/pgcrypto.js +45 -77
- package/dist/adapters/postgresql/tools/pgcrypto.js.map +1 -1
- package/dist/adapters/postgresql/tools/postgis/basic.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/postgis/basic.js +121 -93
- package/dist/adapters/postgresql/tools/postgis/basic.js.map +1 -1
- package/dist/adapters/postgresql/tools/schema/index.d.ts +16 -0
- package/dist/adapters/postgresql/tools/schema/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/schema/index.js +32 -0
- package/dist/adapters/postgresql/tools/schema/index.js.map +1 -0
- package/dist/adapters/postgresql/tools/schema/objects.d.ts +15 -0
- package/dist/adapters/postgresql/tools/schema/objects.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/schema/objects.js +378 -0
- package/dist/adapters/postgresql/tools/schema/objects.js.map +1 -0
- package/dist/adapters/postgresql/tools/schema/views.d.ts +15 -0
- package/dist/adapters/postgresql/tools/schema/views.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/{schema.js → schema/views.js} +64 -386
- package/dist/adapters/postgresql/tools/schema/views.js.map +1 -0
- package/dist/adapters/postgresql/tools/stats/advanced.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/stats/advanced.js +1 -218
- package/dist/adapters/postgresql/tools/stats/advanced.js.map +1 -1
- package/dist/adapters/postgresql/tools/stats/math-utils.d.ts +33 -0
- package/dist/adapters/postgresql/tools/stats/math-utils.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/stats/math-utils.js +225 -0
- package/dist/adapters/postgresql/tools/stats/math-utils.js.map +1 -0
- package/dist/adapters/postgresql/tools/text/index.d.ts +16 -0
- package/dist/adapters/postgresql/tools/text/index.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/text/index.js +33 -0
- package/dist/adapters/postgresql/tools/text/index.js.map +1 -0
- package/dist/adapters/postgresql/tools/text/matching.d.ts +17 -0
- package/dist/adapters/postgresql/tools/text/matching.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/text/matching.js +565 -0
- package/dist/adapters/postgresql/tools/text/matching.js.map +1 -0
- package/dist/adapters/postgresql/tools/text/search.d.ts +17 -0
- package/dist/adapters/postgresql/tools/text/search.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/text/search.js +653 -0
- package/dist/adapters/postgresql/tools/text/search.js.map +1 -0
- package/dist/adapters/postgresql/tools/transactions.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/transactions.js +11 -27
- package/dist/adapters/postgresql/tools/transactions.js.map +1 -1
- package/dist/adapters/postgresql/tools/vector/{basic.d.ts → data.d.ts} +10 -8
- package/dist/adapters/postgresql/tools/vector/data.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/vector/data.js +540 -0
- package/dist/adapters/postgresql/tools/vector/data.js.map +1 -0
- package/dist/adapters/postgresql/tools/vector/index.d.ts.map +1 -1
- package/dist/adapters/postgresql/tools/vector/index.js +6 -2
- package/dist/adapters/postgresql/tools/vector/index.js.map +1 -1
- package/dist/adapters/postgresql/tools/vector/management.d.ts +11 -0
- package/dist/adapters/postgresql/tools/vector/management.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/vector/management.js +425 -0
- package/dist/adapters/postgresql/tools/vector/management.js.map +1 -0
- package/dist/adapters/postgresql/tools/vector/query.d.ts +14 -0
- package/dist/adapters/postgresql/tools/vector/query.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/vector/query.js +767 -0
- package/dist/adapters/postgresql/tools/vector/query.js.map +1 -0
- package/dist/adapters/postgresql/tools/vector/{advanced.d.ts → search-advanced.d.ts} +4 -5
- package/dist/adapters/postgresql/tools/vector/search-advanced.d.ts.map +1 -0
- package/dist/adapters/postgresql/tools/vector/search-advanced.js +626 -0
- package/dist/adapters/postgresql/tools/vector/search-advanced.js.map +1 -0
- package/dist/auth/scopes.d.ts.map +1 -1
- package/dist/auth/scopes.js +3 -1
- package/dist/auth/scopes.js.map +1 -1
- package/dist/cli/args.d.ts +3 -2
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +4 -3
- package/dist/cli/args.js.map +1 -1
- package/dist/cli.js +16 -4
- package/dist/cli.js.map +1 -1
- package/dist/codemode/api/aliases.d.ts +14 -0
- package/dist/codemode/api/aliases.d.ts.map +1 -0
- package/dist/codemode/api/aliases.js +503 -0
- package/dist/codemode/api/aliases.js.map +1 -0
- package/dist/codemode/api/group-api.d.ts +23 -0
- package/dist/codemode/api/group-api.d.ts.map +1 -0
- package/dist/codemode/api/group-api.js +179 -0
- package/dist/codemode/api/group-api.js.map +1 -0
- package/dist/codemode/{api.d.ts → api/index.d.ts} +5 -4
- package/dist/codemode/api/index.d.ts.map +1 -0
- package/dist/codemode/api/index.js +195 -0
- package/dist/codemode/api/index.js.map +1 -0
- package/dist/codemode/api/maps.d.ts +47 -0
- package/dist/codemode/api/maps.d.ts.map +1 -0
- package/dist/codemode/api/maps.js +529 -0
- package/dist/codemode/api/maps.js.map +1 -0
- package/dist/codemode/api/normalize.d.ts +13 -0
- package/dist/codemode/api/normalize.d.ts.map +1 -0
- package/dist/codemode/api/normalize.js +120 -0
- package/dist/codemode/api/normalize.js.map +1 -0
- package/dist/codemode/index.d.ts +1 -1
- package/dist/codemode/index.d.ts.map +1 -1
- package/dist/codemode/index.js +1 -1
- package/dist/codemode/index.js.map +1 -1
- package/dist/codemode/sandbox.d.ts.map +1 -1
- package/dist/codemode/sandbox.js +8 -25
- package/dist/codemode/sandbox.js.map +1 -1
- package/dist/filtering/ToolConstants.d.ts +11 -11
- package/dist/filtering/ToolConstants.d.ts.map +1 -1
- package/dist/filtering/ToolConstants.js +28 -15
- package/dist/filtering/ToolConstants.js.map +1 -1
- package/dist/filtering/ToolFilter.d.ts +0 -32
- package/dist/filtering/ToolFilter.d.ts.map +1 -1
- package/dist/filtering/ToolFilter.js +0 -43
- package/dist/filtering/ToolFilter.js.map +1 -1
- package/dist/server/McpServer.d.ts +1 -1
- package/dist/server/McpServer.d.ts.map +1 -1
- package/dist/server/McpServer.js +1 -2
- package/dist/server/McpServer.js.map +1 -1
- package/dist/transports/http.d.ts +55 -10
- package/dist/transports/http.d.ts.map +1 -1
- package/dist/transports/http.js +301 -50
- package/dist/transports/http.js.map +1 -1
- package/dist/types/filtering.d.ts +1 -1
- package/dist/types/filtering.d.ts.map +1 -1
- package/dist/types/index.d.ts +2 -2
- package/dist/types/index.d.ts.map +1 -1
- package/dist/types/index.js.map +1 -1
- package/dist/types/mcp.d.ts +0 -21
- package/dist/types/mcp.d.ts.map +1 -1
- package/dist/types/schema.d.ts +0 -79
- package/dist/types/schema.d.ts.map +1 -1
- package/dist/utils/fts-config.d.ts +0 -6
- package/dist/utils/fts-config.d.ts.map +1 -1
- package/dist/utils/fts-config.js +1 -1
- package/dist/utils/fts-config.js.map +1 -1
- package/dist/utils/icons.d.ts.map +1 -1
- package/dist/utils/icons.js +5 -0
- package/dist/utils/icons.js.map +1 -1
- package/dist/utils/identifiers.d.ts.map +1 -1
- package/dist/utils/identifiers.js +6 -6
- package/dist/utils/identifiers.js.map +1 -1
- package/dist/utils/logger.d.ts +6 -6
- package/dist/utils/logger.d.ts.map +1 -1
- package/dist/utils/logger.js +18 -15
- package/dist/utils/logger.js.map +1 -1
- package/dist/utils/progress-utils.d.ts +3 -14
- package/dist/utils/progress-utils.d.ts.map +1 -1
- package/dist/utils/progress-utils.js +2 -21
- package/dist/utils/progress-utils.js.map +1 -1
- package/dist/utils/version.d.ts +9 -0
- package/dist/utils/version.d.ts.map +1 -0
- package/dist/utils/version.js +12 -0
- package/dist/utils/version.js.map +1 -0
- package/dist/utils/where-clause.d.ts +4 -0
- package/dist/utils/where-clause.d.ts.map +1 -1
- package/dist/utils/where-clause.js +16 -0
- package/dist/utils/where-clause.js.map +1 -1
- package/package.json +6 -4
- package/dist/adapters/postgresql/schemas/core.d.ts.map +0 -1
- package/dist/adapters/postgresql/schemas/core.js.map +0 -1
- package/dist/adapters/postgresql/schemas/extensions.d.ts +0 -852
- package/dist/adapters/postgresql/schemas/extensions.d.ts.map +0 -1
- package/dist/adapters/postgresql/schemas/extensions.js +0 -1202
- package/dist/adapters/postgresql/schemas/extensions.js.map +0 -1
- package/dist/adapters/postgresql/schemas/jsonb.d.ts +0 -541
- package/dist/adapters/postgresql/schemas/jsonb.d.ts.map +0 -1
- package/dist/adapters/postgresql/schemas/jsonb.js +0 -814
- package/dist/adapters/postgresql/schemas/jsonb.js.map +0 -1
- package/dist/adapters/postgresql/schemas/postgis.d.ts.map +0 -1
- package/dist/adapters/postgresql/schemas/postgis.js.map +0 -1
- package/dist/adapters/postgresql/schemas/stats.d.ts.map +0 -1
- package/dist/adapters/postgresql/schemas/stats.js.map +0 -1
- package/dist/adapters/postgresql/tools/citext.d.ts +0 -18
- package/dist/adapters/postgresql/tools/citext.d.ts.map +0 -1
- package/dist/adapters/postgresql/tools/citext.js.map +0 -1
- package/dist/adapters/postgresql/tools/introspection.d.ts +0 -15
- package/dist/adapters/postgresql/tools/introspection.d.ts.map +0 -1
- package/dist/adapters/postgresql/tools/introspection.js +0 -1682
- package/dist/adapters/postgresql/tools/introspection.js.map +0 -1
- package/dist/adapters/postgresql/tools/jsonb/advanced.d.ts.map +0 -1
- package/dist/adapters/postgresql/tools/jsonb/advanced.js.map +0 -1
- package/dist/adapters/postgresql/tools/jsonb/basic.d.ts +0 -20
- package/dist/adapters/postgresql/tools/jsonb/basic.d.ts.map +0 -1
- package/dist/adapters/postgresql/tools/jsonb/basic.js.map +0 -1
- package/dist/adapters/postgresql/tools/monitoring.d.ts +0 -13
- package/dist/adapters/postgresql/tools/monitoring.d.ts.map +0 -1
- package/dist/adapters/postgresql/tools/monitoring.js.map +0 -1
- package/dist/adapters/postgresql/tools/partitioning.d.ts +0 -13
- package/dist/adapters/postgresql/tools/partitioning.d.ts.map +0 -1
- package/dist/adapters/postgresql/tools/partitioning.js.map +0 -1
- package/dist/adapters/postgresql/tools/schema.d.ts +0 -13
- package/dist/adapters/postgresql/tools/schema.d.ts.map +0 -1
- package/dist/adapters/postgresql/tools/schema.js.map +0 -1
- package/dist/adapters/postgresql/tools/text.d.ts +0 -13
- package/dist/adapters/postgresql/tools/text.d.ts.map +0 -1
- package/dist/adapters/postgresql/tools/text.js +0 -1082
- package/dist/adapters/postgresql/tools/text.js.map +0 -1
- package/dist/adapters/postgresql/tools/vector/advanced.d.ts.map +0 -1
- package/dist/adapters/postgresql/tools/vector/advanced.js +0 -958
- package/dist/adapters/postgresql/tools/vector/advanced.js.map +0 -1
- package/dist/adapters/postgresql/tools/vector/basic.d.ts.map +0 -1
- package/dist/adapters/postgresql/tools/vector/basic.js +0 -1165
- package/dist/adapters/postgresql/tools/vector/basic.js.map +0 -1
- package/dist/codemode/api.d.ts.map +0 -1
- package/dist/codemode/api.js +0 -1544
- package/dist/codemode/api.js.map +0 -1
- package/dist/utils/promptGenerator.d.ts +0 -20
- package/dist/utils/promptGenerator.d.ts.map +0 -1
- package/dist/utils/promptGenerator.js +0 -81
- package/dist/utils/promptGenerator.js.map +0 -1
|
@@ -0,0 +1,332 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* PostgreSQL Performance Tools - Database Diagnostics
|
|
3
|
+
*
|
|
4
|
+
* Consolidates key performance metrics into a single actionable report:
|
|
5
|
+
* slow queries, blocking locks, connection pressure, cache hit ratio,
|
|
6
|
+
* disk usage, and top tables by size/activity.
|
|
7
|
+
*/
|
|
8
|
+
import { z } from "zod";
|
|
9
|
+
import { readOnly } from "../../../../utils/annotations.js";
|
|
10
|
+
import { getToolIcons } from "../../../../utils/icons.js";
|
|
11
|
+
import { formatPostgresError } from "../core/error-helpers.js";
|
|
12
|
+
// =============================================================================
|
|
13
|
+
// Schemas
|
|
14
|
+
// =============================================================================
|
|
15
|
+
const DiagnoseInputSchemaBase = z.object({
|
|
16
|
+
schema: z
|
|
17
|
+
.string()
|
|
18
|
+
.optional()
|
|
19
|
+
.describe("Filter top tables to a specific schema"),
|
|
20
|
+
topN: z
|
|
21
|
+
.any()
|
|
22
|
+
.optional()
|
|
23
|
+
.describe("Number of top tables to return (default: 10)"),
|
|
24
|
+
});
|
|
25
|
+
const DiagnoseInputSchema = DiagnoseInputSchemaBase.transform((data) => ({
|
|
26
|
+
schema: data.schema,
|
|
27
|
+
topN: Math.max(1, Math.min(100, Number(data.topN) || 10)),
|
|
28
|
+
}));
|
|
29
|
+
function rateValue(value, warningThreshold, criticalThreshold, higherIsBetter) {
|
|
30
|
+
if (higherIsBetter) {
|
|
31
|
+
if (value >= warningThreshold)
|
|
32
|
+
return "healthy";
|
|
33
|
+
if (value >= criticalThreshold)
|
|
34
|
+
return "warning";
|
|
35
|
+
return "critical";
|
|
36
|
+
}
|
|
37
|
+
if (value <= warningThreshold)
|
|
38
|
+
return "healthy";
|
|
39
|
+
if (value <= criticalThreshold)
|
|
40
|
+
return "warning";
|
|
41
|
+
return "critical";
|
|
42
|
+
}
|
|
43
|
+
const statusWeight = {
|
|
44
|
+
healthy: 100,
|
|
45
|
+
warning: 60,
|
|
46
|
+
critical: 20,
|
|
47
|
+
};
|
|
48
|
+
// =============================================================================
|
|
49
|
+
// Helper: safe numeric coercion
|
|
50
|
+
// =============================================================================
|
|
51
|
+
const toNum = (val) => val === null || val === undefined ? 0 : Number(val);
|
|
52
|
+
// =============================================================================
|
|
53
|
+
// Diagnostic Sections
|
|
54
|
+
// =============================================================================
|
|
55
|
+
async function diagnoseSlowQueries(adapter) {
|
|
56
|
+
const result = await adapter.executeQuery(`
|
|
57
|
+
SELECT pid, usename, datname, state,
|
|
58
|
+
now() - query_start AS duration,
|
|
59
|
+
LEFT(query, 200) AS query_preview,
|
|
60
|
+
wait_event_type, wait_event
|
|
61
|
+
FROM pg_stat_activity
|
|
62
|
+
WHERE state = 'active'
|
|
63
|
+
AND query NOT ILIKE '%pg_stat_activity%'
|
|
64
|
+
AND now() - query_start > interval '1 second'
|
|
65
|
+
ORDER BY duration DESC
|
|
66
|
+
LIMIT 20
|
|
67
|
+
`);
|
|
68
|
+
const queries = result.rows ?? [];
|
|
69
|
+
const count = queries.length;
|
|
70
|
+
const recommendations = [];
|
|
71
|
+
if (count >= 5) {
|
|
72
|
+
recommendations.push("Multiple slow queries detected — review query plans with pg_explain_analyze");
|
|
73
|
+
}
|
|
74
|
+
if (count >= 10) {
|
|
75
|
+
recommendations.push("High number of slow queries — check for missing indexes with pg_index_recommendations");
|
|
76
|
+
}
|
|
77
|
+
const status = rateValue(count, 2, 5, false);
|
|
78
|
+
return { status, data: { slowQueries: queries, count }, recommendations };
|
|
79
|
+
}
|
|
80
|
+
async function diagnoseBlockingLocks(adapter) {
|
|
81
|
+
const result = await adapter.executeQuery(`
|
|
82
|
+
SELECT
|
|
83
|
+
blocked.pid AS blocked_pid,
|
|
84
|
+
blocked.usename AS blocked_user,
|
|
85
|
+
LEFT(blocked.query, 200) AS blocked_query,
|
|
86
|
+
blocking.pid AS blocking_pid,
|
|
87
|
+
blocking.usename AS blocking_user,
|
|
88
|
+
LEFT(blocking.query, 200) AS blocking_query,
|
|
89
|
+
blocked.wait_event_type
|
|
90
|
+
FROM pg_stat_activity blocked
|
|
91
|
+
JOIN pg_locks bl ON bl.pid = blocked.pid
|
|
92
|
+
JOIN pg_locks kl ON kl.transactionid = bl.transactionid AND kl.pid != bl.pid
|
|
93
|
+
JOIN pg_stat_activity blocking ON blocking.pid = kl.pid
|
|
94
|
+
WHERE NOT bl.granted
|
|
95
|
+
LIMIT 20
|
|
96
|
+
`);
|
|
97
|
+
const blocked = result.rows ?? [];
|
|
98
|
+
const count = blocked.length;
|
|
99
|
+
const recommendations = [];
|
|
100
|
+
if (count > 0) {
|
|
101
|
+
recommendations.push("Active lock contention detected — use pg_locks({showBlocked: true}) for details");
|
|
102
|
+
}
|
|
103
|
+
if (count >= 3) {
|
|
104
|
+
recommendations.push("Significant blocking — consider shorter transactions or advisory locks");
|
|
105
|
+
}
|
|
106
|
+
const status = rateValue(count, 0, 2, false);
|
|
107
|
+
return { status, data: { blockedQueries: blocked, count }, recommendations };
|
|
108
|
+
}
|
|
109
|
+
async function diagnoseConnectionPressure(adapter) {
|
|
110
|
+
const [connResult, maxResult] = await Promise.all([
|
|
111
|
+
adapter.executeQuery(`
|
|
112
|
+
SELECT state, count(*) AS count
|
|
113
|
+
FROM pg_stat_activity
|
|
114
|
+
GROUP BY state
|
|
115
|
+
ORDER BY count DESC
|
|
116
|
+
`),
|
|
117
|
+
adapter.executeQuery(`SHOW max_connections`),
|
|
118
|
+
]);
|
|
119
|
+
const byState = connResult.rows ?? [];
|
|
120
|
+
const totalActive = byState.reduce((sum, r) => sum + toNum(r["count"]), 0);
|
|
121
|
+
const maxConnections = toNum(maxResult.rows?.[0]?.["max_connections"]);
|
|
122
|
+
const usagePercent = maxConnections > 0
|
|
123
|
+
? Math.round((totalActive / maxConnections) * 100 * 10) / 10
|
|
124
|
+
: 0;
|
|
125
|
+
const recommendations = [];
|
|
126
|
+
if (usagePercent > 80) {
|
|
127
|
+
recommendations.push("Connection pool near capacity — consider pg_connection_pool_optimize");
|
|
128
|
+
}
|
|
129
|
+
if (usagePercent > 90) {
|
|
130
|
+
recommendations.push("Critical connection pressure — increase max_connections or use PgBouncer");
|
|
131
|
+
}
|
|
132
|
+
const status = rateValue(usagePercent, 70, 85, false);
|
|
133
|
+
return {
|
|
134
|
+
status,
|
|
135
|
+
data: {
|
|
136
|
+
activeConnections: totalActive,
|
|
137
|
+
maxConnections,
|
|
138
|
+
usagePercent,
|
|
139
|
+
byState,
|
|
140
|
+
},
|
|
141
|
+
recommendations,
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
async function diagnoseCacheHitRatio(adapter) {
|
|
145
|
+
const result = await adapter.executeQuery(`
|
|
146
|
+
SELECT
|
|
147
|
+
sum(heap_blks_read) AS heap_read,
|
|
148
|
+
sum(heap_blks_hit) AS heap_hit,
|
|
149
|
+
CASE WHEN sum(heap_blks_hit) + sum(heap_blks_read) > 0
|
|
150
|
+
THEN round(sum(heap_blks_hit)::numeric / (sum(heap_blks_hit) + sum(heap_blks_read)) * 100, 2)
|
|
151
|
+
ELSE NULL
|
|
152
|
+
END AS ratio
|
|
153
|
+
FROM pg_statio_user_tables
|
|
154
|
+
`);
|
|
155
|
+
const row = result.rows?.[0] ?? {};
|
|
156
|
+
const heapRead = toNum(row["heap_read"]);
|
|
157
|
+
const heapHit = toNum(row["heap_hit"]);
|
|
158
|
+
const ratio = row["ratio"] !== null && row["ratio"] !== undefined
|
|
159
|
+
? Number(row["ratio"])
|
|
160
|
+
: null;
|
|
161
|
+
const recommendations = [];
|
|
162
|
+
if (ratio !== null && ratio < 99) {
|
|
163
|
+
recommendations.push("Cache hit ratio below 99% — consider increasing shared_buffers");
|
|
164
|
+
}
|
|
165
|
+
if (ratio !== null && ratio < 95) {
|
|
166
|
+
recommendations.push("Poor cache hit ratio — working set exceeds memory. Audit large sequential scans");
|
|
167
|
+
}
|
|
168
|
+
const status = ratio === null
|
|
169
|
+
? "healthy"
|
|
170
|
+
: rateValue(ratio, 99, 95, true);
|
|
171
|
+
return { status, data: { heapRead, heapHit, ratio }, recommendations };
|
|
172
|
+
}
|
|
173
|
+
async function diagnoseDiskUsage(adapter) {
|
|
174
|
+
const result = await adapter.executeQuery(`
|
|
175
|
+
SELECT pg_database_size(current_database()) AS total_bytes,
|
|
176
|
+
pg_size_pretty(pg_database_size(current_database())) AS total_size
|
|
177
|
+
`);
|
|
178
|
+
const row = result.rows?.[0] ?? {};
|
|
179
|
+
const totalBytes = toNum(row["total_bytes"]);
|
|
180
|
+
const rawSize = row["total_size"];
|
|
181
|
+
const totalSize = typeof rawSize === "string" ? rawSize : "0 bytes";
|
|
182
|
+
// Disk usage is informational — always healthy (no thresholds)
|
|
183
|
+
return {
|
|
184
|
+
status: "healthy",
|
|
185
|
+
data: { totalBytes, totalSize },
|
|
186
|
+
recommendations: [],
|
|
187
|
+
};
|
|
188
|
+
}
|
|
189
|
+
async function diagnoseTopTables(adapter, topN, schema) {
|
|
190
|
+
const schemaFilter = schema
|
|
191
|
+
? `AND schemaname = '${schema.replace(/'/g, "''")}'`
|
|
192
|
+
: `AND schemaname NOT IN ('pg_catalog', 'information_schema', 'cron', 'topology', 'tiger', 'tiger_data')`;
|
|
193
|
+
const [sizeResult, activityResult] = await Promise.all([
|
|
194
|
+
adapter.executeQuery(`
|
|
195
|
+
SELECT schemaname AS schema, relname AS table,
|
|
196
|
+
pg_total_relation_size(schemaname || '.' || relname) AS total_bytes,
|
|
197
|
+
pg_size_pretty(pg_total_relation_size(schemaname || '.' || relname)) AS total_size,
|
|
198
|
+
n_live_tup AS estimated_rows
|
|
199
|
+
FROM pg_stat_user_tables
|
|
200
|
+
WHERE TRUE ${schemaFilter}
|
|
201
|
+
ORDER BY pg_total_relation_size(schemaname || '.' || relname) DESC
|
|
202
|
+
LIMIT ${String(topN)}
|
|
203
|
+
`),
|
|
204
|
+
adapter.executeQuery(`
|
|
205
|
+
SELECT schemaname AS schema, relname AS table,
|
|
206
|
+
seq_scan + idx_scan AS total_scans,
|
|
207
|
+
seq_scan, idx_scan,
|
|
208
|
+
n_tup_ins AS inserts, n_tup_upd AS updates, n_tup_del AS deletes,
|
|
209
|
+
n_dead_tup AS dead_tuples
|
|
210
|
+
FROM pg_stat_user_tables
|
|
211
|
+
WHERE TRUE ${schemaFilter}
|
|
212
|
+
ORDER BY (seq_scan + idx_scan) DESC
|
|
213
|
+
LIMIT ${String(topN)}
|
|
214
|
+
`),
|
|
215
|
+
]);
|
|
216
|
+
const bySize = sizeResult.rows ?? [];
|
|
217
|
+
const byActivity = activityResult.rows ?? [];
|
|
218
|
+
const recommendations = [];
|
|
219
|
+
// Check for high dead tuple ratios
|
|
220
|
+
for (const row of byActivity) {
|
|
221
|
+
const deadTuples = toNum(row["dead_tuples"]);
|
|
222
|
+
const inserts = toNum(row["inserts"]);
|
|
223
|
+
if (deadTuples > 10000 && inserts > 0 && deadTuples / inserts > 0.5) {
|
|
224
|
+
recommendations.push(`Table ${String(row["schema"])}.${String(row["table"])} has high dead tuples (${String(deadTuples)}) — run pg_vacuum_analyze`);
|
|
225
|
+
break; // Only recommend once
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
// Check for seq scan dominance
|
|
229
|
+
for (const row of byActivity) {
|
|
230
|
+
const seqScan = toNum(row["seq_scan"]);
|
|
231
|
+
const idxScan = toNum(row["idx_scan"]);
|
|
232
|
+
if (seqScan > 1000 && idxScan === 0) {
|
|
233
|
+
recommendations.push(`Table ${String(row["schema"])}.${String(row["table"])} has ${String(seqScan)} seq scans and 0 index scans — add indexes`);
|
|
234
|
+
break;
|
|
235
|
+
}
|
|
236
|
+
}
|
|
237
|
+
return {
|
|
238
|
+
status: recommendations.length > 0 ? "warning" : "healthy",
|
|
239
|
+
data: { bySize, byActivity },
|
|
240
|
+
recommendations,
|
|
241
|
+
};
|
|
242
|
+
}
|
|
243
|
+
// =============================================================================
|
|
244
|
+
// Tool Factory
|
|
245
|
+
// =============================================================================
|
|
246
|
+
export function createDiagnoseTool(adapter) {
|
|
247
|
+
return {
|
|
248
|
+
name: "pg_diagnose_database_performance",
|
|
249
|
+
description: "Consolidates key performance metrics into a single actionable report: " +
|
|
250
|
+
"slow queries, blocking locks, connection pressure, cache hit ratio, " +
|
|
251
|
+
"disk usage, and top tables by size and activity. Returns per-section " +
|
|
252
|
+
"health ratings and recommendations with an overall health score.",
|
|
253
|
+
inputSchema: DiagnoseInputSchemaBase.shape,
|
|
254
|
+
outputSchema: z.object({
|
|
255
|
+
sections: z.object({
|
|
256
|
+
slowQueries: z.any(),
|
|
257
|
+
blockingLocks: z.any(),
|
|
258
|
+
connectionPressure: z.any(),
|
|
259
|
+
cacheHitRatio: z.any(),
|
|
260
|
+
diskUsage: z.any(),
|
|
261
|
+
topTables: z.any(),
|
|
262
|
+
}),
|
|
263
|
+
overallScore: z.number(),
|
|
264
|
+
overallStatus: z.enum(["healthy", "warning", "critical"]),
|
|
265
|
+
totalRecommendations: z.number(),
|
|
266
|
+
allRecommendations: z.array(z.string()),
|
|
267
|
+
}),
|
|
268
|
+
group: "performance",
|
|
269
|
+
annotations: readOnly("Diagnose database performance"),
|
|
270
|
+
icons: getToolIcons("performance", readOnly("Diagnose database performance")),
|
|
271
|
+
handler: async (params, _context) => {
|
|
272
|
+
try {
|
|
273
|
+
const parsed = DiagnoseInputSchema.safeParse(params);
|
|
274
|
+
if (!parsed.success) {
|
|
275
|
+
return {
|
|
276
|
+
success: false,
|
|
277
|
+
error: `Validation error: ${parsed.error.issues.map((i) => i.message).join(", ")}`,
|
|
278
|
+
};
|
|
279
|
+
}
|
|
280
|
+
const { schema, topN } = parsed.data;
|
|
281
|
+
// Run all diagnostics in parallel
|
|
282
|
+
const [slowQueries, blockingLocks, connectionPressure, cacheHitRatio, diskUsage, topTables,] = await Promise.all([
|
|
283
|
+
diagnoseSlowQueries(adapter),
|
|
284
|
+
diagnoseBlockingLocks(adapter),
|
|
285
|
+
diagnoseConnectionPressure(adapter),
|
|
286
|
+
diagnoseCacheHitRatio(adapter),
|
|
287
|
+
diagnoseDiskUsage(adapter),
|
|
288
|
+
diagnoseTopTables(adapter, topN, schema),
|
|
289
|
+
]);
|
|
290
|
+
// Calculate overall score
|
|
291
|
+
const sections = [
|
|
292
|
+
slowQueries,
|
|
293
|
+
blockingLocks,
|
|
294
|
+
connectionPressure,
|
|
295
|
+
cacheHitRatio,
|
|
296
|
+
topTables,
|
|
297
|
+
];
|
|
298
|
+
const overallScore = Math.round(sections.reduce((sum, s) => sum + statusWeight[s.status], 0) /
|
|
299
|
+
sections.length);
|
|
300
|
+
const overallStatus = overallScore >= 90
|
|
301
|
+
? "healthy"
|
|
302
|
+
: overallScore >= 60
|
|
303
|
+
? "warning"
|
|
304
|
+
: "critical";
|
|
305
|
+
const allRecommendations = sections.flatMap((s) => s.recommendations);
|
|
306
|
+
return {
|
|
307
|
+
sections: {
|
|
308
|
+
slowQueries,
|
|
309
|
+
blockingLocks,
|
|
310
|
+
connectionPressure,
|
|
311
|
+
cacheHitRatio,
|
|
312
|
+
diskUsage,
|
|
313
|
+
topTables,
|
|
314
|
+
},
|
|
315
|
+
overallScore,
|
|
316
|
+
overallStatus,
|
|
317
|
+
totalRecommendations: allRecommendations.length,
|
|
318
|
+
allRecommendations,
|
|
319
|
+
};
|
|
320
|
+
}
|
|
321
|
+
catch (error) {
|
|
322
|
+
return {
|
|
323
|
+
success: false,
|
|
324
|
+
error: formatPostgresError(error, {
|
|
325
|
+
tool: "pg_diagnose_database_performance",
|
|
326
|
+
}),
|
|
327
|
+
};
|
|
328
|
+
}
|
|
329
|
+
},
|
|
330
|
+
};
|
|
331
|
+
}
|
|
332
|
+
//# sourceMappingURL=diagnostics.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,wCAAwC,CAAC;IACrD,IAAI,EAAE,CAAC;SACJ,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvE,MAAM,EAAE,IAAI,CAAC,MAAM;IACnB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;CAC1D,CAAC,CAAC,CAAC;AAcJ,SAAS,SAAS,CAChB,KAAa,EACb,gBAAwB,EACxB,iBAAyB,EACzB,cAAuB;IAEvB,IAAI,cAAc,EAAE,CAAC;QACnB,IAAI,KAAK,IAAI,gBAAgB;YAAE,OAAO,SAAS,CAAC;QAChD,IAAI,KAAK,IAAI,iBAAiB;YAAE,OAAO,SAAS,CAAC;QACjD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,KAAK,IAAI,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,KAAK,IAAI,iBAAiB;QAAE,OAAO,SAAS,CAAC;IACjD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,YAAY,GAAiC;IACjD,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF,MAAM,KAAK,GAAG,CAAC,GAAY,EAAU,EAAE,CACrC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAEtD,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,KAAK,UAAU,mBAAmB,CAChC,OAAwB;IAIxB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;;;;;;;;;;;GAWzC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,eAAe,CAAC,IAAI,CAClB,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,eAAe,CAAC,IAAI,CAClB,uFAAuF,CACxF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAE7C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,CAAC;AAC5E,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,OAAwB;IAIxB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;;;;;;;;;;;;;;;GAezC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,eAAe,CAAC,IAAI,CAClB,iFAAiF,CAClF,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,eAAe,CAAC,IAAI,CAClB,wEAAwE,CACzE,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAE7C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,CAAC;AAC/E,CAAC;AAED,KAAK,UAAU,0BAA0B,CAAC,OAAwB;IAQhE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAChD,OAAO,CAAC,YAAY,CAAC;;;;;KAKpB,CAAC;QACF,OAAO,CAAC,YAAY,CAAC,sBAAsB,CAAC;KAC7C,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACvE,MAAM,YAAY,GAChB,cAAc,GAAG,CAAC;QAChB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,cAAc,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE;QAC5D,CAAC,CAAC,CAAC,CAAC;IAER,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACtB,eAAe,CAAC,IAAI,CAClB,sEAAsE,CACvE,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QACtB,eAAe,CAAC,IAAI,CAClB,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAEtD,OAAO;QACL,MAAM;QACN,IAAI,EAAE;YACJ,iBAAiB,EAAE,WAAW;YAC9B,cAAc;YACd,YAAY;YACZ,OAAO;SACR;QACD,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,OAAwB;IAIxB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;;;;;;;;;GASzC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,MAAM,KAAK,GACT,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,SAAS;QACjD,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACjC,eAAe,CAAC,IAAI,CAClB,gEAAgE,CACjE,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,GAAG,EAAE,EAAE,CAAC;QACjC,eAAe,CAAC,IAAI,CAClB,iFAAiF,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GACV,KAAK,KAAK,IAAI;QACZ,CAAC,CAAE,SAA0B;QAC7B,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAErC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,CAAC;AACzE,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,OAAwB;IAExB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC;;;GAGzC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAEpE,+DAA+D;IAC/D,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE;QAC/B,eAAe,EAAE,EAAE;KACpB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,OAAwB,EACxB,IAAY,EACZ,MAAe;IAOf,MAAM,YAAY,GAAG,MAAM;QACzB,CAAC,CAAC,qBAAqB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG;QACpD,CAAC,CAAC,uGAAuG,CAAC;IAE5G,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACrD,OAAO,CAAC,YAAY,CAAC;;;;;;mBAMN,YAAY;;cAEjB,MAAM,CAAC,IAAI,CAAC;KACrB,CAAC;QACF,OAAO,CAAC,YAAY,CAAC;;;;;;;mBAON,YAAY;;cAEjB,MAAM,CAAC,IAAI,CAAC;KACrB,CAAC;KACH,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,IAAI,EAAE,CAAC;IAE7C,MAAM,eAAe,GAAa,EAAE,CAAC;IAErC,mCAAmC;IACnC,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;QAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACtC,IAAI,UAAU,GAAG,KAAK,IAAI,OAAO,GAAG,CAAC,IAAI,UAAU,GAAG,OAAO,GAAG,GAAG,EAAE,CAAC;YACpE,eAAe,CAAC,IAAI,CAClB,SAAS,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,0BAA0B,MAAM,CAAC,UAAU,CAAC,2BAA2B,CAC9H,CAAC;YACF,MAAM,CAAC,sBAAsB;QAC/B,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;QACvC,IAAI,OAAO,GAAG,IAAI,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YACpC,eAAe,CAAC,IAAI,CAClB,SAAS,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,QAAQ,MAAM,CAAC,OAAO,CAAC,4CAA4C,CAC1H,CAAC;YACF,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAC1D,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE;QAC5B,eAAe;KAChB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,MAAM,UAAU,kBAAkB,CAAC,OAAwB;IACzD,OAAO;QACL,IAAI,EAAE,kCAAkC;QACxC,WAAW,EACT,wEAAwE;YACxE,sEAAsE;YACtE,uEAAuE;YACvE,kEAAkE;QACpE,WAAW,EAAE,uBAAuB,CAAC,KAAK;QAC1C,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC;YACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;gBACjB,WAAW,EAAE,CAAC,CAAC,GAAG,EAAE;gBACpB,aAAa,EAAE,CAAC,CAAC,GAAG,EAAE;gBACtB,kBAAkB,EAAE,CAAC,CAAC,GAAG,EAAE;gBAC3B,aAAa,EAAE,CAAC,CAAC,GAAG,EAAE;gBACtB,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE;gBAClB,SAAS,EAAE,CAAC,CAAC,GAAG,EAAE;aACnB,CAAC;YACF,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;YACxB,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;YACzD,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE;YAChC,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACxC,CAAC;QACF,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,QAAQ,CAAC,+BAA+B,CAAC;QACtD,KAAK,EAAE,YAAY,CACjB,aAAa,EACb,QAAQ,CAAC,+BAA+B,CAAC,CAC1C;QACD,OAAO,EAAE,KAAK,EAAE,MAAe,EAAE,QAAwB,EAAE,EAAE;YAC3D,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,qBAAqB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBACnF,CAAC;gBACJ,CAAC;gBAED,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;gBAErC,kCAAkC;gBAClC,MAAM,CACJ,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,SAAS,EACV,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBACpB,mBAAmB,CAAC,OAAO,CAAC;oBAC5B,qBAAqB,CAAC,OAAO,CAAC;oBAC9B,0BAA0B,CAAC,OAAO,CAAC;oBACnC,qBAAqB,CAAC,OAAO,CAAC;oBAC9B,iBAAiB,CAAC,OAAO,CAAC;oBAC1B,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC;iBACzC,CAAC,CAAC;gBAEH,0BAA0B;gBAC1B,MAAM,QAAQ,GAAG;oBACf,WAAW;oBACX,aAAa;oBACb,kBAAkB;oBAClB,aAAa;oBACb,SAAS;iBACV,CAAC;gBACF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAC7B,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBAC1D,QAAQ,CAAC,MAAM,CAClB,CAAC;gBAEF,MAAM,aAAa,GACjB,YAAY,IAAI,EAAE;oBAChB,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,YAAY,IAAI,EAAE;wBAClB,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC,UAAU,CAAC;gBAEnB,MAAM,kBAAkB,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;gBAEtE,OAAO;oBACL,QAAQ,EAAE;wBACR,WAAW;wBACX,aAAa;wBACb,kBAAkB;wBAClB,aAAa;wBACb,SAAS;wBACT,SAAS;qBACV;oBACD,YAAY;oBACZ,aAAa;oBACb,oBAAoB,EAAE,kBAAkB,CAAC,MAAM;oBAC/C,kBAAkB;iBACnB,CAAC;YACJ,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,mBAAmB,CAAC,KAAK,EAAE;wBAChC,IAAI,EAAE,kCAAkC;qBACzC,CAAC;iBACH,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* PostgreSQL Performance Tools
|
|
3
3
|
*
|
|
4
4
|
* Query analysis, statistics, and performance monitoring.
|
|
5
|
-
*
|
|
5
|
+
* 24 tools total.
|
|
6
6
|
*/
|
|
7
7
|
import type { PostgresAdapter } from "../../PostgresAdapter.js";
|
|
8
8
|
import type { ToolDefinition } from "../../../../types/index.js";
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAwCjE;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,eAAe,GACvB,cAAc,EAAE,CA2BlB"}
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
* PostgreSQL Performance Tools
|
|
3
3
|
*
|
|
4
4
|
* Query analysis, statistics, and performance monitoring.
|
|
5
|
-
*
|
|
5
|
+
* 24 tools total.
|
|
6
6
|
*/
|
|
7
7
|
// Import from sub-modules
|
|
8
8
|
import { createExplainTool, createExplainAnalyzeTool, createExplainBuffersTool, } from "./explain.js";
|
|
@@ -10,6 +10,8 @@ import { createIndexStatsTool, createTableStatsTool, createStatStatementsTool, c
|
|
|
10
10
|
import { createLocksTool, createBloatCheckTool, createCacheHitRatioTool, } from "./monitoring.js";
|
|
11
11
|
import { createSeqScanTablesTool, createIndexRecommendationsTool, createQueryPlanCompareTool, } from "./analysis.js";
|
|
12
12
|
import { createPerformanceBaselineTool, createConnectionPoolOptimizeTool, createPartitionStrategySuggestTool, } from "./optimization.js";
|
|
13
|
+
import { createDiagnoseTool } from "./diagnostics.js";
|
|
14
|
+
import { createDetectQueryAnomaliesTool, createDetectBloatRiskTool, createDetectConnectionSpikeTool, } from "./anomaly-detection.js";
|
|
13
15
|
/**
|
|
14
16
|
* Get all performance tools
|
|
15
17
|
*/
|
|
@@ -35,6 +37,10 @@ export function getPerformanceTools(adapter) {
|
|
|
35
37
|
createDuplicateIndexesTool(adapter),
|
|
36
38
|
createVacuumStatsTool(adapter),
|
|
37
39
|
createQueryPlanStatsTool(adapter),
|
|
40
|
+
createDiagnoseTool(adapter),
|
|
41
|
+
createDetectQueryAnomaliesTool(adapter),
|
|
42
|
+
createDetectBloatRiskTool(adapter),
|
|
43
|
+
createDetectConnectionSpikeTool(adapter),
|
|
38
44
|
];
|
|
39
45
|
}
|
|
40
46
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,6BAA6B,EAC7B,gCAAgC,EAChC,kCAAkC,GACnC,MAAM,mBAAmB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,6BAA6B,EAC7B,gCAAgC,EAChC,kCAAkC,GACnC,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,+BAA+B,GAChC,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAwB;IAExB,OAAO;QACL,iBAAiB,CAAC,OAAO,CAAC;QAC1B,wBAAwB,CAAC,OAAO,CAAC;QACjC,wBAAwB,CAAC,OAAO,CAAC;QACjC,oBAAoB,CAAC,OAAO,CAAC;QAC7B,oBAAoB,CAAC,OAAO,CAAC;QAC7B,wBAAwB,CAAC,OAAO,CAAC;QACjC,sBAAsB,CAAC,OAAO,CAAC;QAC/B,eAAe,CAAC,OAAO,CAAC;QACxB,oBAAoB,CAAC,OAAO,CAAC;QAC7B,uBAAuB,CAAC,OAAO,CAAC;QAChC,uBAAuB,CAAC,OAAO,CAAC;QAChC,8BAA8B,CAAC,OAAO,CAAC;QACvC,0BAA0B,CAAC,OAAO,CAAC;QACnC,6BAA6B,CAAC,OAAO,CAAC;QACtC,gCAAgC,CAAC,OAAO,CAAC;QACzC,kCAAkC,CAAC,OAAO,CAAC;QAC3C,uBAAuB,CAAC,OAAO,CAAC;QAChC,0BAA0B,CAAC,OAAO,CAAC;QACnC,qBAAqB,CAAC,OAAO,CAAC;QAC9B,wBAAwB,CAAC,OAAO,CAAC;QACjC,kBAAkB,CAAC,OAAO,CAAC;QAC3B,8BAA8B,CAAC,OAAO,CAAC;QACvC,yBAAyB,CAAC,OAAO,CAAC;QAClC,+BAA+B,CAAC,OAAO,CAAC;KACzC,CAAC;AACJ,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"monitoring.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/monitoring.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;
|
|
1
|
+
{"version":3,"file":"monitoring.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/monitoring.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AAmDpC,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CA6CxE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAsF7E;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,GACvB,cAAc,CAmChB"}
|
|
@@ -4,6 +4,7 @@
|
|
|
4
4
|
import { z } from "zod";
|
|
5
5
|
import { readOnly } from "../../../../utils/annotations.js";
|
|
6
6
|
import { getToolIcons } from "../../../../utils/icons.js";
|
|
7
|
+
import { formatPostgresError } from "../core/error-helpers.js";
|
|
7
8
|
import { LocksOutputSchema, BloatCheckOutputSchema, CacheHitRatioOutputSchema, } from "../../schemas/index.js";
|
|
8
9
|
// Helper to coerce string numbers to JavaScript numbers (PostgreSQL returns BIGINT as strings)
|
|
9
10
|
const toNum = (val) => val === null || val === undefined ? null : Number(val);
|
|
@@ -42,10 +43,11 @@ export function createLocksTool(adapter) {
|
|
|
42
43
|
annotations: readOnly("Lock Information"),
|
|
43
44
|
icons: getToolIcons("performance", readOnly("Lock Information")),
|
|
44
45
|
handler: async (params, _context) => {
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
46
|
+
try {
|
|
47
|
+
const parsed = (params ?? {});
|
|
48
|
+
let sql;
|
|
49
|
+
if (parsed.showBlocked) {
|
|
50
|
+
sql = `SELECT blocked.pid as blocked_pid, blocked.query as blocked_query,
|
|
49
51
|
blocking.pid as blocking_pid, blocking.query as blocking_query
|
|
50
52
|
FROM pg_stat_activity blocked
|
|
51
53
|
JOIN pg_locks bl ON blocked.pid = bl.pid
|
|
@@ -54,17 +56,24 @@ export function createLocksTool(adapter) {
|
|
|
54
56
|
AND bl.pid != lk.pid
|
|
55
57
|
JOIN pg_stat_activity blocking ON lk.pid = blocking.pid
|
|
56
58
|
WHERE NOT bl.granted`;
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
59
|
+
}
|
|
60
|
+
else {
|
|
61
|
+
sql = `SELECT l.locktype, l.relation::regclass, l.mode, l.granted,
|
|
60
62
|
a.pid, a.usename, a.query, a.state
|
|
61
63
|
FROM pg_locks l
|
|
62
64
|
JOIN pg_stat_activity a ON l.pid = a.pid
|
|
63
65
|
WHERE l.pid != pg_backend_pid()
|
|
64
66
|
ORDER BY l.granted, l.pid`;
|
|
67
|
+
}
|
|
68
|
+
const result = await adapter.executeQuery(sql);
|
|
69
|
+
return { locks: result.rows };
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
return {
|
|
73
|
+
success: false,
|
|
74
|
+
error: formatPostgresError(error, { tool: "pg_locks" }),
|
|
75
|
+
};
|
|
65
76
|
}
|
|
66
|
-
const result = await adapter.executeQuery(sql);
|
|
67
|
-
return { locks: result.rows };
|
|
68
77
|
},
|
|
69
78
|
};
|
|
70
79
|
}
|
|
@@ -86,31 +95,32 @@ export function createBloatCheckTool(adapter) {
|
|
|
86
95
|
annotations: readOnly("Bloat Check"),
|
|
87
96
|
icons: getToolIcons("performance", readOnly("Bloat Check")),
|
|
88
97
|
handler: async (params, _context) => {
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
98
|
+
try {
|
|
99
|
+
const parsed = BloatCheckSchema.parse(params);
|
|
100
|
+
// Parse schema from table if it contains a dot (e.g., 'myschema.orders')
|
|
101
|
+
let tableName = parsed.table;
|
|
102
|
+
let schemaName = parsed.schema;
|
|
103
|
+
if (tableName?.includes(".")) {
|
|
104
|
+
const parts = tableName.split(".");
|
|
105
|
+
schemaName = schemaName ?? parts[0];
|
|
106
|
+
tableName = parts[1] ?? tableName;
|
|
107
|
+
}
|
|
108
|
+
let whereClause = "n_dead_tup > 0";
|
|
109
|
+
const queryParams = [];
|
|
110
|
+
if (schemaName !== undefined) {
|
|
111
|
+
queryParams.push(schemaName);
|
|
112
|
+
whereClause += ` AND schemaname = $${String(queryParams.length)}`;
|
|
113
|
+
}
|
|
114
|
+
if (tableName !== undefined) {
|
|
115
|
+
queryParams.push(tableName);
|
|
116
|
+
whereClause += ` AND relname = $${String(queryParams.length)}`;
|
|
117
|
+
}
|
|
118
|
+
// P154: Validate table/schema existence before querying
|
|
119
|
+
const validationError = await validatePerformanceTableExists(adapter, tableName, schemaName);
|
|
120
|
+
if (validationError !== null) {
|
|
121
|
+
return { success: false, error: validationError };
|
|
122
|
+
}
|
|
123
|
+
const sql = `SELECT schemaname, relname as table_name,
|
|
114
124
|
n_live_tup as live_tuples, n_dead_tup as dead_tuples,
|
|
115
125
|
CASE WHEN n_live_tup > 0 THEN round((100.0 * n_dead_tup / n_live_tup)::numeric, 2) ELSE 0 END as dead_pct,
|
|
116
126
|
pg_size_pretty(pg_table_size(relid)) as table_size
|
|
@@ -118,18 +128,25 @@ export function createBloatCheckTool(adapter) {
|
|
|
118
128
|
WHERE ${whereClause}
|
|
119
129
|
ORDER BY n_dead_tup DESC
|
|
120
130
|
LIMIT 20`;
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
131
|
+
const result = await adapter.executeQuery(sql, queryParams);
|
|
132
|
+
// Coerce numeric fields to JavaScript numbers
|
|
133
|
+
const tables = (result.rows ?? []).map((row) => ({
|
|
134
|
+
...row,
|
|
135
|
+
live_tuples: toNum(row["live_tuples"]),
|
|
136
|
+
dead_tuples: toNum(row["dead_tuples"]),
|
|
137
|
+
dead_pct: toNum(row["dead_pct"]),
|
|
138
|
+
}));
|
|
139
|
+
return {
|
|
140
|
+
tables,
|
|
141
|
+
count: tables.length,
|
|
142
|
+
};
|
|
143
|
+
}
|
|
144
|
+
catch (error) {
|
|
145
|
+
return {
|
|
146
|
+
success: false,
|
|
147
|
+
error: formatPostgresError(error, { tool: "pg_bloat_check" }),
|
|
148
|
+
};
|
|
149
|
+
}
|
|
133
150
|
},
|
|
134
151
|
};
|
|
135
152
|
}
|
|
@@ -143,21 +160,29 @@ export function createCacheHitRatioTool(adapter) {
|
|
|
143
160
|
annotations: readOnly("Cache Hit Ratio"),
|
|
144
161
|
icons: getToolIcons("performance", readOnly("Cache Hit Ratio")),
|
|
145
162
|
handler: async (_params, _context) => {
|
|
146
|
-
|
|
163
|
+
try {
|
|
164
|
+
const sql = `SELECT
|
|
147
165
|
sum(heap_blks_read) as heap_read,
|
|
148
166
|
sum(heap_blks_hit) as heap_hit,
|
|
149
167
|
CASE WHEN sum(heap_blks_read) + sum(heap_blks_hit) > 0
|
|
150
168
|
THEN round(100.0 * sum(heap_blks_hit) / (sum(heap_blks_hit) + sum(heap_blks_read)), 2)
|
|
151
169
|
ELSE 100 END as cache_hit_ratio
|
|
152
170
|
FROM pg_statio_user_tables`;
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
171
|
+
const result = await adapter.executeQuery(sql);
|
|
172
|
+
const row = result.rows?.[0];
|
|
173
|
+
// Always return an object with nullable fields (never return null)
|
|
174
|
+
return {
|
|
175
|
+
heap_read: row ? toNum(row["heap_read"]) : null,
|
|
176
|
+
heap_hit: row ? toNum(row["heap_hit"]) : null,
|
|
177
|
+
cache_hit_ratio: row ? toNum(row["cache_hit_ratio"]) : null,
|
|
178
|
+
};
|
|
179
|
+
}
|
|
180
|
+
catch (error) {
|
|
181
|
+
return {
|
|
182
|
+
success: false,
|
|
183
|
+
error: formatPostgresError(error, { tool: "pg_cache_hit_ratio" }),
|
|
184
|
+
};
|
|
185
|
+
}
|
|
161
186
|
},
|
|
162
187
|
};
|
|
163
188
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"monitoring.js","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/monitoring.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAEhC,+FAA+F;AAC/F,MAAM,KAAK,GAAG,CAAC,GAAY,EAAiB,EAAE,CAC5C,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAEzD;;;;GAIG;AACH,KAAK,UAAU,8BAA8B,CAC3C,OAAwB,EACxB,KAAc,EACd,MAAe;IAEf,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEnC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,YAAY,CAC7C,kEAAkE,EAClE,CAAC,MAAM,CAAC,CACT,CAAC;QACF,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzD,OAAO,WAAW,MAAM,mFAAmF,CAAC;QAC9G,CAAC;IACH,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,YAAY,GAAG,MAAM,IAAI,QAAQ,CAAC;QACxC,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,YAAY,CAC5C,qFAAqF,EACrF,CAAC,YAAY,EAAE,KAAK,CAAC,CACtB,CAAC;QACF,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO,UAAU,YAAY,IAAI,KAAK,0DAA0D,CAAC;QACnG,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAwB;IACtD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,gCAAgC;QAC7C,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACpC,CAAC;QACF,YAAY,EAAE,iBAAiB;QAC/B,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC;QACzC,KAAK,EAAE,YAAY,CAAC,aAAa,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAAC;QAChE,OAAO,EAAE,KAAK,EAAE,MAAe,EAAE,QAAwB,EAAE,EAAE;YAC3D,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,EAAE,CAA8B,CAAC;
|
|
1
|
+
{"version":3,"file":"monitoring.js","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/monitoring.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"optimization.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/optimization.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AA+BpC,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,GACvB,cAAc,CAsFhB;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,eAAe,GACvB,cAAc,CAkHhB;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,eAAe,GACvB,cAAc,
|
|
1
|
+
{"version":3,"file":"optimization.d.ts","sourceRoot":"","sources":["../../../../../src/adapters/postgresql/tools/performance/optimization.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EAEf,MAAM,4BAA4B,CAAC;AA+BpC,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,eAAe,GACvB,cAAc,CAsFhB;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,eAAe,GACvB,cAAc,CAkHhB;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,eAAe,GACvB,cAAc,CAqLhB"}
|