Skip to content

docs: add IvorySQL 5.4 pgnodemx integration guide - #297

Open
messere1 wants to merge 1 commit into
IvorySQL:v5.4from
messere1:codex/docs-pgnodemx-1105
Open

docs: add IvorySQL 5.4 pgnodemx integration guide#297
messere1 wants to merge 1 commit into
IvorySQL:v5.4from
messere1:codex/docs-pgnodemx-1105

Conversation

@messere1

@messere1 messere1 commented Aug 9, 2026

Copy link
Copy Markdown

Summary

  • add bilingual pgnodemx 1.7 integration documentation for IvorySQL 5.4
  • document PGXS installation, required preloading, least-privilege monitoring access, and representative metric queries
  • cover Oracle-compatible sessions, containers, cgroups, Kubernetes Downward API behavior, and OpenSSL ABI safety
  • update both ecosystem overview tables and navigation trees

Why

pgnodemx exposes Linux node and IvorySQL process metrics through SQL, but users lacked an IvorySQL-specific build and configuration guide. The new documentation also records important environment boundaries that are easy to miss, including hybrid cgroup support and matching the OpenSSL ABI used by IvorySQL.

Fixes IvorySQL/IvorySQL#1105

Validation

Environment: Ubuntu 22.04 x86_64, source-built IvorySQL 5.4 / PostgreSQL 18.4, pgnodemx 1.7.

  • pgnodemx built and installed successfully through IvorySQL PGXS
  • server restart with pgnodemx added to the existing preload list succeeded
  • extension creation and version checks passed
  • /proc memory and disk queries, executable-path lookup, and cgroup-mode detection returned expected data
  • version, memory, and disk queries passed after switching to ivorysql.compatible_mode = oracle
  • both new AsciiDoc pages pass Asciidoctor with --failure-level WARN
  • git diff --check passes

User impact

Monitoring users gain SQL access to host, process, filesystem, container, and Kubernetes metadata using a dedicated pg_monitor account. The guide clearly separates supported /proc metrics from environment-dependent cgroup and Downward API facilities.

Assisted-by: OpenAI:gpt-5
Copilot AI lite review requested due to automatic review settings August 9, 2026 12:36

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@github-actions
github-actions Bot temporarily deployed to pull request August 9, 2026 12:39 Inactive
@github-actions

github-actions Bot commented Aug 9, 2026

Copy link
Copy Markdown

🚀 IvorySQL-Docs Preview Ready

@jiaoshuntian

Copy link
Copy Markdown
Contributor

Thank you for your contribution. We will review it as soon as possible.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Ecosystem Integration: IvorySQL v5 + pgnodemx

3 participants