创建一个支持包

创建一个支持包,收集必要信息以帮助调试问题。

如果您遇到任何无法自行解决的问题,并且需要联系Redis支持以获取帮助,您可以创建一个支持包,该包收集了所有必要的信息以帮助调试您的问题。

注意:
创建支持包的过程可能需要几分钟,并且会在系统上产生负载。

支持包文件

支持包是一个包含所有集群配置和日志的zip文件。

从集群管理器UI下载时,支持包的名称是debuginfo.tar.gz

数据库支持包文件

集群和数据库支持包在database_<bdb_uid>目录中收集数据库详细信息,其中<bdb_uid>是数据库ID,并在<node_uid>目录中收集Redis分片详细信息。

下表描述了包含的文件:

文件 描述
ccs-redis.json 主节点的本地集群配置存储(CCS)。
/database_<bdb_uid>/ 包含特定数据库文件的目录。<bdb_uid> 是数据库的ID。
database_<bdb_uid>_ccs_info.txt 来自集群配置存储(CCS)的数据库信息。包括数据库、端点、分片、副本和CRDB的设置。
database_<bdb_uid>.clientlist 创建支持包时连接到数据库的客户端列表。
database_<bdb_uid>.info 数据库的Redis信息和统计。有关收集字段的详细信息,请参见INFO
database_<bdb_uid>.rladmin 数据库信息。请参阅rladmin info db以查看收集字段的示例。还包括创建时间、最后更改时间、Redis版本、内存限制、持久化类型、驱逐策略、哈希策略,以及是否启用了SSL、备份和电子邮件警报。
database_<bdb_uid>.slowlog 包含慢日志输出,其中包括耗时超过10毫秒的命令。仅在集群设置中slowlog_in_sanitized_supporttrue时包含。
/node_<node_uid>/redis_<shard_uid>.txt 仅适用于指定数据库的每个分片。包括分片配置和信息、慢日志信息和延迟信息。

Node 支持包文件

集群和节点支持包在node_<node_uid>目录中收集节点详细信息,其中<node_uid>是节点ID。

下表描述了包含的文件:

文件 描述
ccs-redis.json 节点的本地集群配置存储(CCS)。
/conf/ 包含配置文件的目录。
/logs/ 包含日志的目录。
node_<node_uid>.ccs 包含集群配置、节点配置和DMC代理配置。
node_<node_uid>_envoy_config.json Envoy 配置。
node_<node_uid>.rladmin 有关集群节点、数据库、端点和分片的信息。请参阅rladmin status以查看示例输出。
node_<node_uid>_sys_info.txt 节点的系统信息包括:
• 套接字文件列表
• 日志文件列表
• 节点上运行的进程
• 磁盘使用情况
• 持久化文件列表
• 内存使用情况
• 网络接口
• 已安装的软件包
• 活动的iptables
• 操作系统和平台
• 网络连接
• Redis进程状态
redis_<shard_uid>.txt 仅适用于指定数据库的每个分片。包括分片配置和信息、慢日志信息和延迟信息。

每个节点的/conf/目录包含以下文件:

  • bootstrap_status.json
  • ccs-paths.conf
  • config.json
  • envoy.yaml
  • gossip_envoy.yaml
  • heartbeatd-config.json
  • last_bootstrap.json
  • local_addr.conf
  • node.id
  • node_local_config.json
  • redislabs_env_config.sh
  • socket.conf
  • supervisord_alert_mgr.conf
  • supervisord_cm_server.conf
  • supervisord_crdb_coordinator.conf
  • supervisord_crdb_worker.conf
  • supervisord_mdns_server.conf
  • supervisord_pdns_server.conf

每个节点的/conf/目录还包含以下密钥和证书模数文件:

  • api_cert.modulus
  • api_key.modulus
  • ccs_internode_encryption_cert.modulus
  • ccs_internode_encryption_key.modulus
  • cm_cert.modulus
  • cm_key.modulus
  • data_internode_encryption_cert.modulus
  • data_internode_encryption_key.modulus
  • gossip_ca_signed_cert.modulus
  • gossip_ca_signed_key.modulus
  • mesh_ca_signed_cert.modulus
  • mesh_ca_signed_key.modulus
  • metrics_exporter_cert.modulus
  • metrics_exporter_key.modulus
  • proxy_cert.modulus
  • proxy_key.modulus
  • syncer_cert.modulus
  • syncer_key.modulus

创建支持包

集群管理器UI方法

要从集群管理器用户界面创建支持包:

  1. 在导航菜单中,选择支持

    Select Support and create a support package.
  2. 选择继续

  3. 创建支持包对话框中,选择运行进程

  4. 该包已创建并由您的浏览器下载。

命令行方法

如果包创建失败并显示internal error,或者如果您无法访问UI,请使用rladmin cluster debug_info命令在集群中的任何节点上从命令行创建集群的支持包:

/opt/redislabs/bin/rladmin cluster debug_info
  • 如果由于/tmp目录空间不足导致rladmin cluster debug_info失败,您可以:

    1. 更改支持包保存的存储位置:

      rladmin cluster config debuginfo_path <path>
      

      redislabs用户必须对所有集群节点上的存储位置具有写权限。

    2. 在集群中的任何节点上运行:

      rladmin cluster debug_info
      
  • 如果 rladmin cluster debug_info 由于其他原因失败,您可以通过在每个节点上使用以下命令从命令行创建集群的支持包:

    /opt/redislabs/bin/debuginfo
    

将tar文件上传到Redis支持。归档文件的路径显示在命令输出中。

REST API 方法

你也可以使用debuginfo REST API请求来创建和下载支持包。

从所有节点和数据库下载调试信息:

GET /v1/cluster/debuginfo

从所有节点下载调试信息:

GET /v1/nodes/debuginfo

要从特定节点下载调试信息,请将以下请求中的<uid>替换为节点ID:

GET /v1/nodes/<uid>/debuginfo

从所有数据库下载调试信息:

GET /v1/bdbs/debuginfo

要从特定数据库下载调试信息,请将以下请求中的<uid>替换为数据库ID:

GET /v1/bdbs/<uid>/debuginfo
RATE THIS PAGE
Back to top ↑