|
| 1 | +## 嘉为蓝鲸Sybase数据库监控插件使用说明 |
| 2 | + |
| 3 | +### 插件功能 |
| 4 | + |
| 5 | +采集器连接数据库后执行sql,转换为监控指标。 |
| 6 | + |
| 7 | +### 版本支持: |
| 8 | + |
| 9 | +操作系统支持: linux, windows |
| 10 | + |
| 11 | +是否支持arm: 支持 |
| 12 | + |
| 13 | +**组件支持版本:** |
| 14 | + |
| 15 | +Sybase ASE: 12.5+ |
| 16 | + |
| 17 | +### 使用指引 |
| 18 | + |
| 19 | +登录数据库并执行命令创建蓝鲸监控账号和授权: |
| 20 | + |
| 21 | +创建用户: weops 密码: Weops123! |
| 22 | +```bash |
| 23 | +sp_addlogin weops, "Weops123!", master |
| 24 | +go |
| 25 | + |
| 26 | +sp_role "grant",mon_role,weops |
| 27 | +go |
| 28 | +``` |
| 29 | + |
| 30 | + |
| 31 | +开启后才能监控 |
| 32 | +sp_configure 'enable monitoring',1 |
| 33 | + |
| 34 | +不开启会报错 |
| 35 | +Msg: 12052, Level: 17, State: 1\nServer: MYSYBASE, Procedure: gtds1, Line: 1:\nCollection of monitoring data for table 'monState' requires that the 'enable monitoring' configuration option(s) be enabled. To set the necessary configuration, contact a user who has the System Administrator (SA) role.\n" |
| 36 | + |
| 37 | +### 参数说明 |
| 38 | + |
| 39 | +| **参数名** | **含义** | **是否必填** | **使用举例** | |
| 40 | +|-------------------------|-------------------------------------------------------------|----------|----------------| |
| 41 | +| SQL_EXPORTER_USER | 数据库用户名(环境变量),特殊字符不需要编码转义 | 是 | sa | |
| 42 | +| SQL_EXPORTER_PASS | 数据库密码(环境变量),特殊字符不需要编码转义 | 是 | myPassword | |
| 43 | +| SQL_EXPORTER_DB_TYPE | 数据库类型(环境变量) | 是 | sybase | |
| 44 | +| SQL_EXPORTER_HOST | 数据库服务IP(环境变量) | 是 | 127.0.0.1 | |
| 45 | +| SQL_EXPORTER_PORT | 数据库服务端口(环境变量) | 是 | 5000 | |
| 46 | +| SQL_EXPORTER_DB_NAME | 数据库名称(环境变量) | 是 | sybase | |
| 47 | +| COLLECTOR_REFS | 采集指标配置名称,对应`collector_name`,一般使用模糊匹配 | 是 | sybase* | |
| 48 | +| SCRAPE_TIMEOUT | 采集超时时间 | 否 | 10s | |
| 49 | +| MAX_CONNECTION_LIFETIME | 最长连接时长 | 否 | 5m | |
| 50 | +| --collector.file | 采集指标配置文件路径(文件参数), *.collector.yml 采集指标配置文件, 包含指标名、维度、sql等内容 | 是 | | |
| 51 | +| --log.level | 日志级别 | 否 | info | |
| 52 | +| --web.listen-address | exporter监听id及端口地址 | 否 | 127.0.0.1:9601 | |
| 53 | + |
| 54 | + |
| 55 | +### 指标列表 |
| 56 | +| **指标ID** | **指标中文名** | **维度ID** | **维度含义** | **单位** | |
| 57 | +|------------------------------------------|-------------|---------------------------------------|------------------|---------| |
| 58 | +| up | 插件运行状态 | - | - | - | |
| 59 | +| sybase_servername | 服务实例名称 | servername | 服务实例名称 | - | |
| 60 | +| sybase_uptime_days | 已运行时间 | InstanceID | 实例ID | day | |
| 61 | +| sybase_deadlocks_total | 死锁总数 | InstanceID | 实例ID | - | |
| 62 | +| sybase_lock_waits_total | 锁等待总数 | InstanceID | 实例ID | - | |
| 63 | +| sybase_connections_total | 连接总数 | InstanceID | 实例ID | - | |
| 64 | +| sybase_transactions_total | 事务总数 | InstanceID | 实例ID | - | |
| 65 | +| sybase_cache_hit_percent | 缓存命中率 | InstanceID, CacheName | 实例ID, 缓存名称 | percent | |
| 66 | +| sybase_cache_size_kb | 缓存大小 | InstanceID, CacheName | 实例ID, 缓存名称 | kb | |
| 67 | +| sybase_physical_writes_total | 物理写入总数 | InstanceID, CacheName | 实例ID, 缓存名称 | - | |
| 68 | +| sybase_buffer_pools | 缓冲池数量 | InstanceID, CacheName | 实例ID, 缓存名称 | - | |
| 69 | +| sybase_cache_partitions | 缓存分区数量 | InstanceID, CacheName | 实例ID, 缓存名称 | - | |
| 70 | +| sybase_last_backup_failed | 上次备份是否失败 | InstanceID, DBName | 实例ID, 数据库名称 | - | |
| 71 | +| sybase_last_backup_duration_seconds | 上次备份到现在的时间差 | InstanceID, DBName | 实例ID, 数据库名称 | s | |
| 72 | +| sybase_transaction_log_full | 事务日志是否已满 | InstanceID, DBName | 实例ID, 数据库名称 | - | |
| 73 | +| sybase_device_filesystem_used_percent | 设备文件系统使用率 | InstanceID, LogicalName, PhysicalName | 实例ID, 逻辑名称, 文件路径 | percent | |
| 74 | +| sybase_device_filesystem_free_mb | 设备文件系统空闲空间 | InstanceID, LogicalName, PhysicalName | 实例ID, 逻辑名称, 文件路径 | mb | |
| 75 | +| sybase_device_size_mb | 设备空间大小 | InstanceID, LogicalName, PhysicalName | 实例ID, 逻辑名称, 文件路径 | mb | |
| 76 | +| sybase_locks_total | 锁总数 | InstanceID, DBName, LockState | 实例ID, 数据库名称, 锁状态 | - | |
| 77 | +| sybase_lock_max_wait_time | 最大等待时间 | InstanceID, DBName, LockState | 实例ID, 数据库名称, 锁状态 | - | |
| 78 | +| sybase_packet_received_total | 接收网络包总数 | InstanceID | 实例ID | - | |
| 79 | +| sybase_packet_sent_total | 发送网络包总数 | InstanceID | 实例ID | - | |
| 80 | +| sybase_bytes_received_total | 接收字节总数 | InstanceID | 实例ID | - | |
| 81 | +| sybase_bytes_sent_total | 发送字节总数 | InstanceID | 实例ID | - | |
| 82 | +| sybase_threads_active | 活动线程数 | InstanceID | 实例ID | - | |
| 83 | +| sybase_thread_worker_memory_bytes | 工作线程内存使用 | InstanceID | 实例ID | bytes | |
| 84 | +| sybase_thread_worker_memory_used_percent | 工作线程内存使用率 | InstanceID | 实例ID | percent | |
| 85 | + |
| 86 | +### 版本日志 |
| 87 | + |
| 88 | +#### weops_sybase_exporter v4.1.2 |
| 89 | +- weops调整 |
| 90 | + |
0 commit comments