企业官网建设流程全解析

1. 项目背景与核心价值

最近在梳理企业级数据库监控方案时，发现很多团队还在用传统的脚本+邮件报警方式管理Oracle数据库。这种模式不仅实时性差，而且当DBA需要同时管理几十个实例时，很难快速定位性能瓶颈。于是花了两个周末时间，用Grafana+OracleDB Exporter搭建了一套开箱即用的监控解决方案。

这套方案最大的特点是用docker-compose实现了"一键部署"，所有组件包括：

• OracleDB Exporter（采集Oracle性能指标）
• Prometheus（时间序列数据库）
• Grafana（可视化大屏）
• 配套的Dashboard模板

实测下来，单个节点从部署到出图不超过15分钟，监控指标延迟控制在10秒内。下面分享具体实现过程和踩坑记录。

2. 环境准备与架构设计

2.1 基础环境要求

• 操作系统：建议Ubuntu 20.04+/CentOS 7+
• Docker版本：20.10.0+
• docker-compose版本：1.29.0+
• 硬件配置（以监控5个Oracle实例为例）：
  • CPU：4核+
  • 内存：8GB+
  • 磁盘：50GB+（建议SSD）

注意：OracleDB Exporter需要通过Oracle Instant Client连接数据库，要求被监控的Oracle版本在11gR2以上。

2.2 组件通信架构

graph LR A[OracleDB] -->|SQL查询| B(OracleDB Exporter) B -->|HTTP暴露metrics| C(Prometheus) C -->|数据查询| D(Grafana)

实际部署时，每个Oracle实例需要配置一个Exporter。Prometheus通过scrape_configs动态发现这些Exporter。

3. 关键组件配置详解

3.1 OracleDB Exporter配置

先准备配置文件oracledb-exporter/config.yml：

default: user: monitor_user password: "secure_password" connection_string: "host:port/service_name" max_idle_conns: 5 max_open_conns: 10 query_timeout: 30

对应的Docker启动参数：

version: '3' services: oracledb-exporter: image: iamseth/oracledb_exporter volumes: - ./config.yml:/config.yml environment: - DATA_SOURCE_NAME=monitor_user/secure_password@host:port/service_name ports: - "9161:9161"

避坑提示：Oracle账户需要额外授予SELECT_CATALOG_ROLE和CREATE SESSION权限，否则会报ORA-01031错误。

3.2 Prometheus配置要点

关键配置在prometheus/prometheus.yml中：

scrape_configs: - job_name: 'oracledb' static_configs: - targets: ['oracledb-exporter:9161'] metrics_path: '/metrics' scrape_interval: 15s

对于多实例监控，建议使用文件服务发现：

scrape_configs: - job_name: 'oracledb' file_sd_configs: - files: - '/etc/prometheus/oracle_targets.json' relabel_configs: - source_labels: [__address__] target_label: instance

3.3 Grafana Dashboard导入

推荐使用ID 3333的官方Oracle仪表板，包含这些关键面板：

• 实例状态（UP/DOWN）
• 表空间使用率
• 会话数趋势
• SQL执行时间Top 10
• 等待事件统计

导入命令：

docker exec -it grafana grafana-cli plugins install grafana-piechart-panel

4. docker-compose全量配置

完整版的docker-compose.yml示例：

version: '3.7' services: prometheus: image: prom/prometheus ports: - "9090:9090" volumes: - ./prometheus:/etc/prometheus command: - '--config.file=/etc/prometheus/prometheus.yml' grafana: image: grafana/grafana ports: - "3000:3000" volumes: - grafana-storage:/var/lib/grafana depends_on: - prometheus oracledb-exporter: image: iamseth/oracledb_exporter ports: - "9161:9161" environment: - DATA_SOURCE_NAME=system/password@oracle:1521/ORCLCDB volumes: - ./oracledb-exporter:/config volumes: grafana-storage:

启动命令：

docker-compose up -d

5. 性能优化实战技巧

5.1 指标采集优化

通过修改Exporter的SQL查询频率降低负载：

custom_metrics: - name: tablespace_usage help: Tablespace usage metrics query: | SELECT tablespace_name, used_percent FROM dba_tablespace_usage_metrics interval: 300

5.2 Prometheus存储优化

调整prometheus.yml中的保留策略：

storage: tsdb: retention: 15d chunk_encoding: xor

5.3 Grafana告警配置

示例：表空间使用率超过90%触发告警

{ "alert": { "name": "Oracle Tablespace Alert", "conditions": [ { "evaluator": { "params": [90], "type": "gt" } } ] } }

6. 生产环境部署建议

6.1 高可用方案

建议的部署架构：

+-----------------+ | Load Balancer | +--------+--------+ | +----------------+----------------+ | | +-------+-------+ +---------+---------+ | Prometheus A | | Prometheus B | +-------+-------+ +---------+---------+ | | +----------------+----------------+ | +--------+--------+ | Shared Storage | +-----------------+

6.2 安全加固措施

1. Exporter启用TLS：

oracledb-exporter: environment: - TLS_KEY_FILE=/certs/key.pem - TLS_CRT_FILE=/certs/cert.pem

2. Grafana配置域账号集成：

[auth.generic_oauth] enabled = true client_id = your_client_id client_secret = your_client_secret auth_url = https://auth.example.com/oauth2/authorize token_url = https://auth.example.com/oauth2/token api_url = https://auth.example.com/oauth2/resource

7. 常见问题排查指南

7.1 Exporter连接失败

错误现象：

ORA-12541: TNS:no listener

排查步骤：

1. 检查Oracle监听状态

   lsnrctl status

2. 验证tnsping连通性

   tnsping ORCLCDB

3. 检查防火墙规则

   iptables -L -n | grep 1521

7.2 指标缺失问题

典型场景：表空间指标未采集

解决方法：

1. 确认监控账户权限

   GRANT SELECT ON dba_tablespaces TO monitor_user;

2. 检查Exporter日志

   docker logs oracledb-exporter

7.3 Prometheus存储异常

错误日志：

msg="Error replaying WAL" err="corruption after 12345678 bytes"

修复方案：

docker exec -it prometheus prometheus --storage.tsdb.retention.time=12h

8. 监控指标深度解析

8.1 关键性能指标

8.2 自定义指标开发

示例：监控长时间运行事务

SELECT COUNT(*) as long_tx_count FROM v$transaction WHERE (SYSDATE - START_DATE) * 24 * 60 > 30

在Exporter配置中添加：

custom_metrics: - name: long_transactions help: Count of transactions running longer than 30 minutes query: | SELECT COUNT(*) as value FROM v$transaction WHERE (SYSDATE - START_DATE) * 24 * 60 > 30 interval: 60

9. 扩展功能实现

9.1 自动发现Oracle实例

使用Consul实现服务发现：

scrape_configs: - job_name: 'oracledb' consul_sd_configs: - server: 'consul:8500' services: ['oracle-exporter']

9.2 与Zabbix集成

通过Grafana Webhook将告警转发到Zabbix：

import requests import json zabbix_payload = { "request": "sender data", "data": [ { "host": "oracle_host", "key": "grafana.alert", "value": alert_message } ] } requests.post(zabbix_url, data=json.dumps(zabbix_payload))

9.3 历史数据分析

配置Prometheus远程存储到VictoriaMetrics：

remote_write: - url: http://victoriametrics:8428/api/v1/write queue_config: capacity: 10000 max_shards: 30

10. 维护与升级策略

10.1 版本升级流程

1. 备份Grafana数据库：

   docker exec grafana pg_dump -U grafana > grafana_backup.sql

2. 更新docker-compose.yml中的镜像版本
3. 执行滚动更新：

   docker-compose pull docker-compose up -d

10.2 日常维护任务

建议的crontab任务：

0 3 * * * docker system prune -f 0 4 * * * docker exec prometheus promtool check rules /etc/prometheus/rules.yml

10.3 性能调优记录

实测数据（监控10个Oracle实例）：