转储数据库审计日志
GaussDB(DWS)记录数据库中的连接和用户活动相关信息。这些审计日志信息有助于用户监控数据库以确保安全、进行故障排除及定位历史操作记录。GaussDB(DWS)的审计日志默认存储于数据库中,用户可以将审计日志转储到OBS中,便于负责监控数据库中活动的用户查看这些日志信息。
- 非OBS场景下,此功能不可用。
- 经典变更规格、增删CN等变更CN场景会导致数据丢失,建议在执行变更期间关闭审计日志转储。
- 开启审计日志转储后,如果保存的审计日志大小超过1G就会转储,这可能会导致查询结果异常,用户请谨慎操作。
- CN节点故障可能导致丢失该节点数据。
- 开启审计日志转储目录分区版本支持:
- 针对8.1.3.x集群仅8.1.3.322及以上集群版本支持,针对8.2.0.x集群仅8.2.0.106及以上集群版本支持,默认打开审计日志转储目录分区且不支持关闭。
- 历史版本需联系技术支持人员升级使用,升级后用户需手动打开。
前提条件
GaussDB(DWS)集群创建成功后,可以为集群开启审计日志转储,将审计日志转储到OBS中,方便查看。开启审计日志转储前需满足如下条件:
开启审计日志转储
- 登录GaussDB(DWS)管理控制台。
- 在左侧导航栏中,单击“集群 > 专属集群 ”。
- 在集群列表中,单击需要开启审计日志转储的集群的名称,然后在左侧导航栏单击“安全设置”。
- 在“审计配置”区域中,开启审计日志转储。
表示开启状态。
每个区域的每个项目首次开启审计日志转储功能时,系统将提示您需创建名称为“DWSAccessOBS”的委托,委托创建成功后,GaussDB(DWS)可以将审计日志转储至OBS中。
默认情况下,只有账号或拥有Security Administrator权限的用户才具备查询委托和创建委托的权限。账号中的IAM用户,默认没有查询委托和创建委托的权限,此时需联系有权限的用户在当前页面完成对GaussDB(DWS)的委托授权。
- 转储目录分区:支持审计日志转储时可采用OBS外表读取,转储至OBS时审计日志会采用csv格式且使用gz格式压缩。
- OBS桶:存储审计数据的OBS桶名称。如果没有可选择的OBS桶,可以单击“查看OBS桶”进入OBS管理控制台创建新的OBS桶,具体操作请参见《对象存储服务用户指南》中的“控制台指南 > 管理桶 > 创建桶”章节。
- OBS路径:在OBS中存储审计文件的自定义目录。多级目录可用“/”进行分隔,不能以“/”开头。路径取值范围:1~50个字符。如果填写的OBS路径不存在时,系统会先创建该OBS路径再进行转储。
- 转储周期(分):根据用户配置的时间,周期性的将数据转储到OBS中。取值范围:5~43200。单位为分钟。
- 单击“应用”。
“配置状态”显示为“应用中”,表示系统正在保存配置。
等待一段时间后再次刷新“配置状态”,当显示为“已同步”,表示已保存配置并生效。
修改审计日志转储
开启审计日志转储后,可以对转储配置进行修改。例如,修改日志存放的OBS桶和路径,转储周期等。
修改审计日志转储具体操作如下:
- 登录GaussDB(DWS)管理控制台。
- 在左侧导航栏中,单击“集群 > 专属集群 ”。
- 在集群列表中,单击您想要修改审计日志转储的集群的名称,然后在左侧导航栏单击“安全设置”。
- 在“审计配置”区域中,修改审计日志转储配置。
- 单击“应用”。
“配置状态”显示为“应用中”,表示系统正在保存配置。
等待一段时间后再次刷新“配置状态”,当显示为“已同步”,表示已保存配置并生效。
- 登录GaussDB(DWS)管理控制台。
- 在左侧导航栏中,单击“集群 > 专属集群 ”。
- 在集群列表中,单击需要查看审计日志转储记录的集群的名称,然后在左侧导航栏单击“安全设置”。
- 在“审计配置”区域中,单击“查看转储记录”。
- 在“审计日记转储记录”弹出框中,单击“查看OBS桶”,进入OBS管理控制台。
- 选择日志存放的OBS桶和文件夹进入查看具体的日志文件。
可以选择将日志文件下载,解压并打开查看。审计日志文件字段说明如下。
表1 审计日志文件字段说明 名称
类型
描述
begintime
timestamp with time zone
操作的执行开始时间。
endtime
timestamp with time zone
操作的执行结束时间。
operation_type
text
操作类型,具体类型见表2。
audit_type
text
审计类型,具体类型见表3。
result
text
操作结果。
username
text
执行操作的用户名。
database
text
数据库名称。
client_conninfo
text
客户端连接信息,即gsql,jdbc或odbc。
object_name
text
操作对象名称。
command_text
text
操作的执行命令。
detail_info
text
执行操作详细信息。
transaction_xid
text
事务ID。
query_id
text
查询ID。
node_name
text
节点名称。
thread_id
text
线程ID。
local_port
text
本地端口。
remote_port
text
远端端口。
表2 operation_type操作类型项 操作类型
描述
audit_switch
表示对用户打开和关闭审计日志操作场景进行审计。
login_logout
表示对用户登录和登出操作场景进行审计。
system
表示对系统的启停、实例切换操作场景进行审计。
sql_parse
表示对SQL语句解析场景进行审计。
user_lock
表示对用户锁定和解锁操作的场景进行审计。
grant_revoke
表示对用户权限授予和回收操作场景进行审计。
violation
表示对用户访问存在越权的场景进行审计。
ddl
表示对DDL操作场景进行审计,因为DDL操作会根据操作对象进行更细粒度控制,仍然沿用审计开关audit_system_object,即由audit_system_object控制对哪些对象的DDL操作进行审计(此处不配置ddl,只要配置了audit_system_object,审计也会生效)。
dml
表示对DML操作场景进行审计。
select
表示对SELECT操作场景进行审计。
internal_event
表示对内部事件操作场景进行审计。
user_func
表示对用户自定义函数、存储过程、匿名块操作场景进行审计。
special_func
表示对特殊函数调用操作场景进行审计,特殊函数包括:pg_terminate_backend和pg_cancel_backend。
copy
表示对COPY操作场景进行审计。
set
表示对SET操作场景进行审计。
transaction
表示对事务操作场景进行审计。
vacuum
表示对VACUUM操作场景进行审计。
analyze
表示对ANALYZE操作场景进行审计。
cursor
表示对游标操作的场景进行审计。
anonymous_block
表示对匿名块操作场景进行审计。
explain
表示对EXPLAIN操作场景进行审计。
show
表示对SHOW操作场景进行审计。
lock_table
表示对锁表操作场景进行审计。
comment
表示对COMMENT操作场景进行审计。
preparestmt
表示对PREPARE、EXECUTE、DEALLOCATE操作场景进行审计。
cluster
表示对CLUSTER操作场景进行审计。
constraints
表示对CONSTRAINTS操作场景进行审计。
checkpoint
表示对CHECKPOINT操作场景进行审计。
barrier
表示对BARRIER操作场景进行审计。
cleanconn
表示对CLEAN CONNECTION操作场景进行审计。
seclabel
表示对安全标签操作进行审计。
notify
表示对通知操作进行审计。
load
表示对加载操作进行审计。
表3 audit_type审计类型项 审计类型
描述
audit_open/audit_close
表示审计类型为打开和关闭审计日志操作。
user_login/user_logout
表示审计类型为用户登录/退出成功的操作和用户。
system_start/system_stop/system_recover/system_switch
表示审计类型为系统的启停、实例切换操作。
sql_wait/sql_parse
表示审计类型为SQL语句解析。
lock_user/unlock_user
表示审计类型为用户锁定和解锁成功的操作。
grant_role/revoke__role
表示审计类型为用户权限授予和回收的操作。
user_violation
表示审计类型为用户访问存在越权的操作。
ddl_数据库对象
表示审计类型为DDL操作,因为DDL操作由会根据操作对象进行更细粒度控制,仍然沿用审计开关audit_system_object,即由audit_system_object控制对哪些对象的DDL操作进行审计(此处不配置ddl,只要配置了audit_system_object,审计也会生效)。
例如:ddl_sequence表示审计类型为序列相关操作。
dml_action_insert/dml_action_delete/dml_action_update/dml_action_merge/dml_action_select
表示审计类型为INSERT、DELETE、UPDATE、MERGE等DML操作。
internal_event
表示审计类型为内部事件。
user_func
表示审计类型为用户自定义函数、存储过程、匿名块操作。
special_func
表示审计类型为特殊函数调用操作,特殊函数包括:pg_terminate_backend和pg_cancel_backend。
copy_to/copy_from
表示审计类型为COPY相关操作。
set_parameter
表示审计类型为SET操作。
trans_begin/trans_commit/trans_prepare/trans_rollback_to/trans_release/trans_savepoint/trans_commit_prepare/trans_rollback_prepare/trans_rollback
表示审计类型为事务相关操作。
vacuum/vacuum_full/vacuum_merge
表示审计类型为VACUUM相关操作。
analyze/analyze_verify
表示审计类型为ANALYZE相关操作。
cursor_declare/cursor_move/cursor_fetch/cursor_close
表示审计类型为游标相关操作。
codeblock_execute
表示审计类型为匿名块。
explain
表示审计类型为EXPLAIN操作。
show
表示审计类型为SHOW操作。
lock_table
表示审计类型为锁表操作。
comment
表示审计类型为COMMENT操作。
prepare/execute/deallocate
表示审计类型为PREPARE、EXECUTE或DEALLOCATE操作。
cluster
表示审计类型为CLUSTER操作。
constraints
表示审计类型为CONSTRAINTS操作。
checkpoint
表示审计类型为CHECKPOINT操作。
barrier
表示审计类型为BARRIER操作。
cleanconn
表示审计类型为CLEAN CONNECTION操作。
seclabel
表示审计类型为安全标签操作。
notify
表示审计类型为通知操作。
load
表示审计类型为加载操作。
关闭审计日志转储
审计日志转储开启后,如果不需要将审计日志转储到OBS中,可以将审计日志转储关闭。
关闭审计日志转储具体操作如下:
- 登录GaussDB(DWS)管理控制台。
- 在左侧导航栏中,单击“集群 > 专属集群 ”。
- 在集群列表中,单击需要关闭审计日志转储的集群的名称,然后在左侧导航栏单击“安全设置”。
- 在“审计配置”区域中,关闭审计日志转储开关。
- 单击“应用”。
“配置状态”显示为“应用中”,表示系统正在保存配置。
等待一段时间后再次刷新“配置状态”,当显示为“已同步”,表示已保存配置并生效。