回拨客户端

提示

来自deepseek解释

原文链接：https://redis.io/docs/latest/operate/rs/clusters/configure/call-home/

回拨客户端每小时收集数据，并通过 POST 请求将每日使用统计信息发送至 https://usage.redis.io/callHome。报告包括内存使用情况、分片详情、已启用功能和其他操作指标。为避免多个集群运行时增加负载，每日报告会在随机时间发送。

这些报告提供了许可证使用情况的洞察，有助于 Redis 确保性能指标符合合同协议、优化服务交付并提供主动客户支持。我们建议在进行任何更改之前先联系 Redis 支持。

收集的数据

以下示例展示了每个数据库每小时收集的数据：

{
  "support_package": true,
  "customer_name": "string",
  "license_hash": "string",
  "usage_data": [
    {
      "date": "2025-03-25T11:42:13.984Z",
      "cluster_UUID": "string",
      "cluster_name": "string",
      "api_version": "string",
      "software_version": "string",
      "bdb_uid": "string",
      "type": "string",
      "shard_type": "string",
      "dominant_shard_criteria": "string",
      "provisioned_memory": 0,
      "used_memory": 0,
      "master_shards_count": 0,
      "no_eviction": true,
      "persistence": true,
      "backup": true,
      "using_redis_search": true,
      "ops_sec": 0,
      "replication": true,
      "active_active": true
    }
  ]
}

更改数据收集计划

默认情况下，集群每小时收集一次使用数据。

要更改数据收集计划，请使用 REST API 请求更新作业调度器设置中的 bdb_usage_report_job_settings：

PUT /v1/job_scheduler
{
  "bdb_usage_report_job_settings": {
    "enabled": true,
    "cron_expression": "*/60 * * * *"
  }
}

将 cron_expression 的值替换为定义新数据收集计划的 cron 表达式。

关闭回拨客户端

要停止回拨客户端向 Redis 发送每日使用统计信息，请使用 REST API 请求更新集群服务配置中的 call_home_agent：

PUT /v1/cluster/services_configuration
{
  "call_home_agent": {
    "operating_mode": "disabled"
  }
}