Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

2.4. 使用缓存管理器

与 Data Grid Cache Manager 交互以获取集群和用量统计。

2.4.1. 获取基本缓存管理器信息
复制链接

使用 GET 请求检索有关缓存管理器的信息。 

GET /rest/v2/cache-managers/{cacheManagerName}
Copy to Clipboard Toggle word wrap

Data Grid 使用 JSON 格式的信息响应，如下例所示： 

{
    "version":"xx.x.x-FINAL",
    "name":"default",
    "coordinator":true,
    "cache_configuration_names":[
        "___protobuf_metadata",
        "cache2",
        "CacheManagerResourceTest",
        "cache1"
    ],
    "cluster_name":"ISPN",
    "physical_addresses":"[127.0.0.1:35770]",
    "coordinator_address":"CacheManagerResourceTest-NodeA-49696",
    "cache_manager_status":"RUNNING",
    "created_cache_count":"3",
    "running_cache_count":"3",
    "node_address":"CacheManagerResourceTest-NodeA-49696",
    "cluster_members":[
        "CacheManagerResourceTest-NodeA-49696",
        "CacheManagerResourceTest-NodeB-28120"
    ],
    "cluster_members_physical_addresses":[
        "127.0.0.1:35770",
        "127.0.0.1:60031"
    ],
    "cluster_size":2,
    "defined_caches":[
        {
            "name":"CacheManagerResourceTest",
            "started":true
        },
        {
            "name":"cache1",
            "started":true
        },
        {
            "name":"___protobuf_metadata",
            "started":true
        },
        {
            "name":"cache2",
            "started":true
        }
    ]

}
Copy to Clipboard Toggle word wrap
  • 版本 包含 Data Grid 版本
  • name 包含配置中定义的缓存管理器的名称
  • 如果缓存 管理器是集群的协调器，则协调器为 true
  • cache_configuration_names 包含缓存管理器中定义的所有缓存配置的数组
  • cluster_ NAME 包含配置中定义的集群名称
  • physical_addresses 包含与缓存管理器关联的物理网络地址
  • coordinator_address 包含集群的协调器的物理网络地址
  • cache_manager_status 缓存管理器的生命周期状态。有关可能的值，请检查 org.infinispan.lifecycle.ComponentStatus 文档
  • created_cache_count 创建缓存的数量，不包括所有内部和外部缓存
  • 运行的创建的缓存的 running_cache_count 数量
  • node_address 包含缓存管理器的逻辑地址
  • cluster_members 和 cluster_members_physical_addresses 一个集群成员的逻辑和物理地址的数组
  • 集群中成员的 cluster_size 数量
  • defined_caches A 列表，缓存管理器中定义的所有缓存，不包括私有缓存，但包括可以访问的内部缓存

2.4.2. 获取集群健康状况
复制链接

使用 GET 请求检索 Data Grid 集群的健康信息。 

GET /rest/v2/cache-managers/{cacheManagerName}/health
Copy to Clipboard Toggle word wrap

Data Grid 使用 JSON 格式的集群健康信息响应，如下例所示： 

{
    "cluster_health":{
        "cluster_name":"ISPN",
        "health_status":"HEALTHY",
        "number_of_nodes":2,
        "node_names":[
            "NodeA-36229",
            "NodeB-28703"
        ]
    },
    "cache_health":[
        {
            "status":"HEALTHY",
            "cache_name":"___protobuf_metadata"
        },
        {
            "status":"HEALTHY",
            "cache_name":"cache2"
        },
        {
            "status":"HEALTHY",
            "cache_name":"mycache"
        },
        {
            "status":"HEALTHY",
            "cache_name":"cache1"
        }
    ]

}
Copy to Clipboard Toggle word wrap

  • cluster_health 包含集群的健康状况

    • cluster_ NAME 指定配置中定义的集群名称。

    • health_status 提供以下之一：

      • DEGRADED 指示至少一个缓存处于降级模式。
      • HEALTHY_REBALANCING 指示至少一个缓存处于重新平衡状态。
      • HEALTHY 表示集群中的所有缓存实例都如预期运行。
      • FAILED 表示缓存未能从提供的配置开始。
    • number_of_nodes 显示群集成员的总数。为非集群(standalone)服务器返回值 0。
    • node_names 是所有群集成员的数组。单机服务器为空。

  • cache_health 包含每个缓存的健康状况信息

    • Status HEALTHY, DEGRADED, HEALTHY_REBALANCING 或 FAILED
    • cache_name 配置中定义的缓存名称。

2.4.3. 获取缓存管理器健康状态
复制链接

使用不需要身份验证的 GET 请求检索 Cache Managers 的健康状况。 

GET /rest/v2/cache-managers/{cacheManagerName}/health/status
Copy to Clipboard Toggle word wrap

Data Grid 以 text/plain 格式之一响应：

  • 健康
  • HEALTHY_REBALANCING
  • DEGRADED
  • 失败

2.4.4. 检查 REST 端点可用性
复制链接

验证 Data Grid server REST 端点可用性与 HEAD 请求。 

HEAD /rest/v2/cache-managers/{cacheManagerName}/health
Copy to Clipboard Toggle word wrap

如果您收到成功的响应代码，则 Data Grid REST 服务器正在运行并服务请求。

2.4.5. 获取缓存管理器的全局配置
复制链接

使用 GET 请求检索缓存管理器的全局配置。 

GET /rest/v2/cache-managers/{cacheManagerName}/config
Copy to Clipboard Toggle word wrap
Expand
表 2.13. Headers
标头必需/可选参数

accept

可选

返回内容所需的格式。支持的格式为 application/json 和 application/xml。如果未提供标头，则假定 JSON。

参考

GlobalConfiguration

2.4.6. 获取所有缓存的配置
复制链接

检索具有 GET 请求的所有缓存的配置。 

GET /rest/v2/cache-managers/{cacheManagerName}/cache-configs
Copy to Clipboard Toggle word wrap

Data Grid 使用包含每个缓存和缓存配置的 JSON 阵列响应，如下例所示： 

[
  {
      "name":"cache1",
      "configuration":{
          "distributed-cache":{
              "mode":"SYNC",
              "partition-handling":{
                  "when-split":"DENY_READ_WRITES"
              },
              "statistics":true
          }
      }
  },
  {
      "name":"cache2",
      "configuration":{
          "distributed-cache":{
              "mode":"SYNC",
              "transaction":{
                  "mode":"NONE"
              }
          }
      }
  }
]
Copy to Clipboard Toggle word wrap

2.4.7. 列出可用的缓存模板
复制链接

使用 GET 请求检索所有可用的 Data Grid 缓存模板。 

GET /rest/v2/cache-managers/{cacheManagerName}/cache-configs/templates
Copy to Clipboard Toggle word wrap
提示

2.4.8. （实验性）包含缓存状态和信息
复制链接

检索缓存管理器的所有可用缓存列表，以及缓存状态和详情，以及 GET 请求。 

GET /rest/v2/cache-managers/{cacheManagerName}/caches
Copy to Clipboard Toggle word wrap

Data Grid 使用列出和描述每个可用缓存的 JSON 阵列响应，如下例所示： 

[ {
  "status" : "RUNNING",
  "name" : "cache1",
  "type" : "local-cache",
  "simple_cache" : false,
  "transactional" : false,
  "persistent" : false,
  "bounded": false,
  "secured": false,
  "indexed": true,
  "has_remote_backup": true,
  "health":"HEALTHY"
}, {
  "status" : "RUNNING",
  "name" : "cache2",
  "type" : "distributed-cache",
  "simple_cache" : false,
  "transactional" : true,
  "persistent" : false,
  "bounded": false,
  "secured": false,
  "indexed": true,
  "has_remote_backup": true,
  "health":"HEALTHY"
}]
Copy to Clipboard Toggle word wrap

2.4.9. 获取缓存管理器统计信息
复制链接

使用 GET 请求检索缓存管理器的统计信息。 

GET /rest/v2/cache-managers/{cacheManagerName}/stats
Copy to Clipboard Toggle word wrap

Data Grid 以 JSON 格式使用缓存管理器统计信息响应，如下例所示： 

{
    "statistics_enabled":true,
    "read_write_ratio":0.0,
    "time_since_start":1,
    "time_since_reset":1,
    "number_of_entries":0,
    "total_number_of_entries":0,
    "off_heap_memory_used":0,
    "data_memory_used":0,
    "misses":0,
    "remove_hits":0,
    "remove_misses":0,
    "evictions":0,
    "average_read_time":0,
    "average_read_time_nanos":0,
    "average_write_time":0,
    "average_write_time_nanos":0,
    "average_remove_time":0,
    "average_remove_time_nanos":0,
    "required_minimum_number_of_nodes":1,
    "hits":0,
    "stores":0,
    "current_number_of_entries_in_memory":0,
    "hit_ratio":0.0,
    "retrievals":0
}
Copy to Clipboard Toggle word wrap
  • 如果为 Cache Manager 启用了统计集合，则 statistics_enabled 为 true。
  • read_write_ratio 显示所有缓存的读/写比率。
  • time_since_start 显示自缓存管理器启动以来的时间（以秒为单位）。
  • time_since_reset 显示缓存管理器统计上次重置后的秒数。
  • number_of_entries 显示来自 Cache Manager 的所有缓存中当前条目总数。这个统计只返回本地缓存实例中的条目。
  • total_number_of_entries 显示缓存管理器的所有缓存上执行的存储操作数量。
  • off_heap_memory_used 显示此缓存容器使用的非堆内存的数量，以字节为单位。
  • data_memory_used 显示 （以字节为单位 ），当前驱除算法估计用于所有缓存中的数据。如果没有启用驱除，则返回 0。
  • misses 显示所有缓存中的 get （） 丢失的数量。
  • remove_hits 显示所有缓存间删除命中的数量。
  • remove_misses 显示所有缓存间删除未命中的数量。
  • 驱除 显示所有缓存上的驱除数量。
  • average_read_time 显示所有缓存中的 get （） 操作的平均毫秒数。
  • average_read_time_nanos 与 average_read_time 相同，但以纳秒为单位。
  • average_remove_time 显示所有缓存中的 remove （） 操作的平均毫秒数。
  • average_remove_time_nanos 与 average_remove_time 相同，但以纳秒为单位。
  • required_minimum_number_of_nodes 显示保证数据一致性所需的最小节点数量。
  • hits 提供所有缓存的 get （） 命中数。
  • 存储 提供所有缓存的 put （） 操作数量。
  • current_number_of_entries_in_memory 显示当前缓存中的条目总数，不包括传递的条目。
  • hit_ratio 为所有缓存提供总百分比的 hit/(hit+miss)比率。
  • 检索 显示 get （） 操作总数。

2.4.10. 使用缓存管理器的跨站点操作
复制链接

使用缓存管理器执行跨站点操作，以将操作应用到所有缓存。

2.4.10.1. 获取备份位置状态
复制链接

使用 GET 请求，从缓存管理器检索所有备份位置的状态。 

GET /rest/v2/cache-managers/{cacheManagerName}/x-site/backups/
Copy to Clipboard Toggle word wrap

Data Grid 以 JSON 格式的状态响应，如下例所示： 

{
   "SFO-3":{
      "status":"online"
   },
   "NYC-2":{
      "status":"mixed",
      "online":[
         "CACHE_1"
      ],
      "offline":[
         "CACHE_2"
      ]
   }
}
Copy to Clipboard Toggle word wrap
Expand
表 2.14. 返回的状态
值描述

online

本地集群中的所有节点都有一个带有备份位置的跨站点视图。

离线

本地集群中没有带有备份位置的跨站点视图。

mixed

本地集群中的某些节点具有带有备份位置的跨站点视图，本地集群中的其他节点没有跨站点视图。响应表示每个节点的状态。

2.4.10.2. 执行备份位置离线
复制链接

使用 ?action=take-offline 参数使备份位置离线。 

POST /rest/v2/cache-managers/{cacheManagerName}/x-site/backups/{siteName}?action=take-offline
Copy to Clipboard Toggle word wrap

2.4.10.3. 使备份位置在线
复制链接

使用 ?action=bring-online 参数在线启动备份位置。 

POST /rest/v2/cache-managers/{cacheManagerName}/x-site/backups/{siteName}?action=bring-online
Copy to Clipboard Toggle word wrap

2.4.10.4. 启动状态传输
复制链接

使用 ?action=start-push-state 参数将所有缓存的状态推送到远程站点。 

POST /rest/v2/cache-managers/{cacheManagerName}/x-site/backups/{siteName}?action=start-push-state
Copy to Clipboard Toggle word wrap

2.4.10.5. 取消状态传输
复制链接

使用 ?action=cancel-push-state 参数取消持续状态传输操作。 

POST /rest/v2/cache-managers/{cacheManagerName}/x-site/backups/{siteName}?action=cancel-push-state
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat