postgresai
postgresai – Postgres observability built for humans and AI agents
파일 탐색기
최종 버전 다운로드 (.zip)- pgai:checkup.md
- pgai:issues.md
- CLAUDE.md
- marketplace.json
- pre-commit
- codeql-analysis.yml
- mirror-to-gitlab.yml
- dependabot.yml
- launch.example.json
- demo-checkup.cast
- demo-checkup.gif
- demo-claude-code.cast
- demo-claude-code.gif
- demo-llm.cast
- demo-llm.gif
- demo-mcp.cast
- demo-mcp.gif
- demo.cast
- demo.gif
- postgresai.png
- postgres-ai.ts
- aas-onboard.ts
- auth-server.ts
- checkup-api.ts
- checkup-baseline.ts
- checkup-dictionary.ts
- checkup-summary.ts
- checkup.ts
- config.ts
- dblab.ts
- feedback.ts
- init.ts
- instances.ts
- issues.ts
- joe.ts
- mcp-server.ts
- metrics-loader.ts
- org-scope-mcp.ts
- org-scope.ts
- pkce.ts
- reports.ts
- storage.ts
- supabase.ts
- util.ts
- postgres-ai.js
- package.json
- README.md
- embed-checkup-dictionary.ts
- embed-metrics.ts
- generate-release-notes.ts
- sync-schemas.mjs
- 01.helpers.sql
- 02.permissions.sql
- 03.role.sql
- 01.role.sql
- 02.extensions.sql
- 03.permissions.sql
- 04.optional_rds.sql
- 05.optional_self_managed.sql
- 06.helpers.sql
- aas-onboard.test.ts
- auth.test.ts
- checkup-api-utf8.test.ts
- checkup-baseline.test.ts
- checkup.integration.test.ts
- checkup.test.ts
- compose-cmd.test.ts
- config-consistency.test.ts
- config-permissions.test.ts
- contract-version.test.ts
- dblab.cli.test.ts
- dblab.test.ts
- feedback.test.ts
- init.integration.test.ts
- init.test.ts
- issues.cli.test.ts
- issues.test.ts
- joe.cli.test.ts
- joe.test.ts
- local-install-env.test.ts
- mcp-server.test.ts
- monitoring.test.ts
- org-scope-mcp.test.ts
- org-scope-wire.test.ts
- org-scope.test.ts
- orgs.cli.test.ts
- permission-check-sql.test.ts
- PERMISSION_CHECK_TEST_SUMMARY.md
- reports.cli.test.ts
- reports.test.ts
- schema-package.test.ts
- schema-validation.test.ts
- storage.test.ts
- supabase.test.ts
- targets-add-config.test.ts
- test-utils.ts
- unknown-command.test.ts
- upgrade.test.ts
- util.test.ts
- .gitignore
- .npmignore
- bun.lock
- bunfig.toml
- CHANGELOG.md
- package.json
- README.md
- tsconfig.json
- e2e_bloat_reduction.sh
- architecture.md
- faq.md
- function_reference.md
- installation.md
- installer_cli_reference.md
- README.md
- runbook.md
- 01_basic_installation.sql
- 02_functionality.sql
- 03_security.sql
- 04_reindex_progress.sql
- README.md
- run_tests.sh
- .gitlab-ci.yml
- CONTRIBUTING.md
- COPYRIGHT
- index_pilot.sh
- index_pilot_fdw.sql
- index_pilot_functions.sql
- index_pilot_tables.sql
- LICENSE
- README.md
- uninstall.sql
- Dashboard_10_Index health.json
- Dashboard_11_Single_index_analysis.json
- Dashboard_12_SLRU.json
- Dashboard_13_Lock_waits.json
- Dashboard_14_IO_Statistics.json
- Dashboard_1_Node_performance_overview.json
- Dashboard_2_Aggregated_query_analysis.json
- Dashboard_3_Single_query_analysis.json
- Dashboard_4_Wait_Sampling_Dashboard.json
- Dashboard_5_Backup_stats.json
- Dashboard_6_Replication_and_HA.json
- Dashboard_7_Autovacuum_and_xmin_horizon.json
- Dashboard_8_Table_Stats.json
- Dashboard_9_Single_table_analysis.json
- README.md
- Self_Monitoring_Dashboard.json
- dashboards.yml
- datasources.yml
- grafana.ini
- metrics.yml
- metrics.yml
- prometheus.yml
- generate-pgwatch-sources.sh
- postgres-entrypoint.sh
- postgres-reports.sh
- 00-configure-pg-hba.sh
- init.sql
- 00-replication-hba.sh
- 01-create-replicator.sh
- init.sql
- Dockerfile
- init-configs.sh
- postgresai.rb
- app.py
- Dockerfile
- promql_utils.py
- requirements.txt
- test_app.py
- pgai.ts
- package.json
- README.md
- .dockerignore
- Dockerfile
- Dashboard_10_Index health.json
- Dashboard_11_Single_index_analysis.json
- Dashboard_12_SLRU.json
- Dashboard_13_Lock_waits.json
- Dashboard_14_IO_Statistics.json
- Dashboard_1_Node_performance_overview.json
- Dashboard_2_Aggregated_query_analysis.json
- Dashboard_3_Single_query_analysis.json
- Dashboard_4_Wait_Sampling_Dashboard.json
- Dashboard_5_Backup_stats.json
- Dashboard_6_Replication_and_HA.json
- Dashboard_7_Autovacuum_and_xmin_horizon.json
- Dashboard_8_Table_Stats.json
- Dashboard_9_Single_table_analysis.json
- Self_Monitoring_Dashboard.json
- metrics-postgres.yml
- metrics-prometheus.yml
- _helpers.tpl
- cadvisor-daemonset.yaml
- cadvisor-service.yaml
- flask-deployment.yaml
- flask-service.yaml
- grafana-dashboards.yaml
- grafana-datasources.yaml
- ingress.yaml
- node-exporter-daemonset.yaml
- node-exporter-service.yaml
- pgwatch-config.yaml
- pgwatch-postgres-deployment.yaml
- pgwatch-postgres-service.yaml
- pgwatch-prometheus-deployment.yaml
- pgwatch-prometheus-service.yaml
- postgres-exporter-deployment.yaml
- postgres-exporter-service.yaml
- prometheus-configmap.yaml
- rbac.yaml
- reporter-cronjob.yaml
- secret.yaml
- serviceaccount.yaml
- sink-postgres-configmap.yaml
- sink-postgres-service.yaml
- sink-postgres-statefulset.yaml
- victoriametrics-service.yaml
- victoriametrics-statefulset.yaml
- .helmignore
- Chart.lock
- Chart.yaml
- INSTALLATION_GUIDE.md
- README.md
- RELEASE.md
- release.sh
- test-release-logic.sh
- test-release.sh
- values.yaml
- cleanup-ttl.sh
- deploy.sh
- destroy.sh
- cloudflare-dns.sh
- sanitize-branch.sh
- pgbench-variable.sh
- docker-compose.preview.template.yml
- instances.yml
- docker-compose.yml
- setup.sh
- traefik.yml
- provision-vm.sh
- RUNBOOK.md
- pr-review-checklist.md
- release-checklist.md
- release-readiness.sh
- failure-modes.md
- gitlab-ci-quality.yml
- pr-review-prompt.md
- QUALITY_ENGINEERING_GUIDE.md
- A002.schema.json
- A003.schema.json
- A004.schema.json
- A007.schema.json
- A013.schema.json
- D001.schema.json
- D004.schema.json
- F001.schema.json
- F002.schema.json
- F003.schema.json
- F004.schema.json
- F005.schema.json
- F009.schema.json
- G001.schema.json
- G003.schema.json
- H001.schema.json
- H002.schema.json
- H004.schema.json
- I001.schema.json
- K001.schema.json
- K003.schema.json
- K004.schema.json
- K005.schema.json
- K006.schema.json
- K007.schema.json
- K008.schema.json
- M001.schema.json
- M002.schema.json
- M003.schema.json
- N001.schema.json
- query.schema.json
- __init__.py
- Dockerfile
- logger.py
- postgres_reports.py
- report_schemas.py
- requirements-dev.txt
- requirements.txt
- checkup.sh
- claude-code.sh
- llm.sh
- mcp.sh
- demo-record.sh
- demo.sh
- rotate-vm-auth.sh
- run_reporter_local.sh
- telemetry.ts
- containers.ts
- disk.ts
- memory.ts
- oom.ts
- collect.ts
- config.ts
- reporter.ts
- types.ts
- collect.test.ts
- config.test.ts
- containers.test.ts
- disk.test.ts
- memory.test.ts
- oom.test.ts
- reporter.test.ts
- telemetry.test.ts
- bun.lock
- Dockerfile
- package.json
- README.md
- tsconfig.json
- kms_encryption.tftest.hcl
- .gitignore
- instances.yml.tpl
- main.tf
- outputs.tf
- QUICKSTART.md
- README.md
- terraform.tfvars.example
- user_data.sh
- variables.tf
- README.md
- test_golden_snapshots.ambr
- check_compose_retention_config.sh
- conftest.py
- COVERAGE.md
- memory_parsing.json
- query_id_validation.json
- schema.json
- test_cadvisor_resources.py
- test_compliance.py
- test_compose_parameterization.py
- test_coverage_boost.py
- test_flask_resources.py
- test_golden_snapshots.py
- test_init_configs.py
- test_mr219_monitoring_guards.py
- test_mr262_pgwatch_topn_integration.py
- test_property.py
- test_vm_auth.py
- test_work_item_196_monitoring.py
- test_work_item_199_lock_waits.py
- test_work_item_290_db_stats.py
- __init__.py
- test_grafana_version_display.py
- README.md
- synthetic-secrets.env
- __init__.py
- conftest.py
- test_d3_query_text_panel_compose.py
- test_default_time_range.py
- test_grafana_check_for_updates_disabled.py
- test_legend_sort_declared.py
- test_no_duplicate_targets_in_panel.py
- test_postgres_panels_pin_database.py
- test_titles_no_todo_markers.py
- test_wait_events_queries.py
- __init__.py
- create_lock_contention.sql
- README.md
- run_test.sh
- test_lock_waits_metric.py
- __init__.py
- test_amp_auth.py
- test_promql_escape_integration.py
- test_query_texts_endpoint.py
- test_version_endpoint.py
- test_vm_auth.py
- test_multixact_size_metric.py
- __init__.py
- conftest.py
- test_additional_edge_cases.py
- test_amp_auth.py
- test_build_metadata.py
- test_check_title.py
- test_cluster_methods.py
- test_connection_errors.py
- test_error_warning_paths.py
- test_extract_queryids_from_reports_unit.py
- test_f002_wraparound_metric_sql.py
- test_final_coverage_push.py
- test_final_push_to_85.py
- test_format_bytes.py
- test_format_setting_value.py
- test_formatters.py
- test_generate_from_a003.py
- test_generate_methods_comprehensive.py
- test_generators_hourly_unit.py
- test_generators_query_unit.py
- test_generators_unit.py
- test_hourly_helper_methods.py
- test_hourly_topk_pgss_multi_unit.py
- test_improved_deep_assertions.py
- test_main_cli.py
- test_memory_analysis.py
- test_non_hourly_paths.py
- test_parameter_variations.py
- test_postgres_integration.py
- test_postgres_reports_script.py
- test_postgres_sink_unit.py
- test_promql_escaping.py
- test_queryid_extraction.py
- test_report_schemas.py
- test_report_schemas_hourly.py
- test_settings_filtering.py
- test_simple_helpers.py
- test_upload_report_file_unit.py
- test_version_memory_parsing.py
- test_vm_auth.py
- __init__.py
- test_settings_metric.py
- README.md
- requirements.txt
- run_test.sh
- test_metrics_sql_static.py
- test_xmin_horizon_metric.py
- __init__.py
- e2e.cli.sh
- single_index_analysis.md
- .cursor
- .env.example
- .gitignore
- .gitlab-ci.yml
- .gitmodules
- .pre-commit-config.yaml
- CHANGELOG.md
- conftest.py
- CONTRIBUTING.md
- COPYRIGHT
- docker-compose.local.yml
- docker-compose.override.example.yml
- docker-compose.yml
- gitleaks.toml
- instances.demo.yml
- LICENSE
- Makefile
- NOTICE
- pytest.ini
- README.md
- SECURITY.md
- TMP_MON_PREVIEWS.md
# 설치 가이드
1. 코드 내려받기
git clone https://github.com/postgres-ai/postgresai
깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.
cd postgresai
방금 내려받은 프로젝트 폴더 안으로 이동합니다.
2. 공식 설치 스크립트
쉬움 추천사전 준비물
- Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다.
npm install -g postgresai@0.15.0
npm 레지스트리에 배포된 패키지를 전역으로 설치합니다. 소스 클론이 필요 없습니다.
설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
3. Docker
쉬움사전 준비물
- Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
- Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.
> docker compose exec sink-postgres pg_dumpall -U postgres > sink-pg15.sql
compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.
> docker compose exec -T sink-postgres psql -U postgres < sink-pg15.sql
compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.
docker compose pull
compose 설정 파일에 정의된 서비스들을 대상으로 명령을 실행합니다.
터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
4. Node.js
쉬움사전 준비물
npm install -g postgresai@0.15.0
npm 레지스트리에 배포된 패키지를 전역으로 설치합니다. 소스 클론이 필요 없습니다.
명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
5. Python
쉬움사전 준비물
python3 -m pip install -r reporter/requirements-dev.txt
requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.
에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.
이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.
6. Make
보통사전 준비물
- Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
- Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.
make
생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.
에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.
// repository documentation
Was this content helpful?
(0 ratings)
