2.5. 使用 Data Grid 服务器


监控和管理 Data Grid 服务器实例。

2.5.1. 检索基本服务器信息

使用 GET 请求查看有关 Data Grid 服务器的基本信息。

GET /rest/v2/server
Copy to Clipboard Toggle word wrap

Data Grid 以 JSON 格式的服务器名称、代码名称和版本响应,如下例所示:

{
  "version":"Infinispan 'Codename' xx.x.x.Final"
}
Copy to Clipboard Toggle word wrap

2.5.2. 获取缓存管理器

使用 GET 请求检索 Data Grid 服务器的缓存管理器列表。

GET /rest/v2/server/cache-managers
Copy to Clipboard Toggle word wrap

Data Grid 响应为服务器配置的缓存管理器名称的数组。

注意

网格目前仅支持每台服务器有一个缓存管理器。

2.5.3. 将缓存添加到 Ignore 列表中

配置 Data Grid,以从客户端请求中临时排除特定的缓存。发送包含缓存管理器名称和缓存名称的空 POST 请求。

POST /rest/v2/server/ignored-caches/{cache}
Copy to Clipboard Toggle word wrap

如果未找到缓存或缓存管理器,Data Grid 会在 204 (未内容 )中成功添加到 ignore 列表或 404 (Not Found) 时响应。

注意

网格目前仅支持每台服务器有一个缓存管理器。对于将来的兼容性,您必须在请求中提供 Cache Manager 名称。

2.5.4. 从 Ignore 列表中删除缓存

使用 DELETE 请求从 ignore 列表中删除缓存。

DELETE /rest/v2/server/ignored-caches/{cache}
Copy to Clipboard Toggle word wrap

如果未找到缓存或缓存管理器,Data Grid 会在 204 (未内容 )中成功从忽略列表中或 404 (Not Found) 进行响应。

2.5.5. 确认 Ignored Caches

确认缓存被忽略了 GET 请求。

GET /rest/v2/server/ignored-caches/
Copy to Clipboard Toggle word wrap

2.5.6. 获取服务器配置

使用 GET 请求检索 Data Grid 服务器配置。

GET /rest/v2/server/config
Copy to Clipboard Toggle word wrap

Data Grid 以 JSON 格式响应配置,如下所示:

{
    "server":{
        "interfaces":{
            "interface":{
                "name":"public",
                "inet-address":{
                    "value":"127.0.0.1"
                }
            }
        },
        "socket-bindings":{
            "port-offset":0,
            "default-interface":"public",
            "socket-binding":[
                {
                    "name":"memcached",
                    "port":11221,
                    "interface":"memcached"
                }
            ]
        },
        "security":{
            "security-realms":{
                "security-realm":{
                    "name":"default"
                }
            }
        },
        "endpoints":{
            "socket-binding":"default",
            "security-realm":"default",
            "hotrod-connector":{
                "name":"hotrod"
            },
            "rest-connector":{
                "name":"rest"
            }
        }
    }
}
Copy to Clipboard Toggle word wrap

2.5.7. 获取环境变量

使用 GET 请求检索 Data Grid 服务器的所有环境变量。

GET /rest/v2/server/env
Copy to Clipboard Toggle word wrap

2.5.8. 获取 JVM 内存详情

使用 GET 请求检索 Data Grid 服务器的 JVM 内存用量信息。

GET /rest/v2/server/memory
Copy to Clipboard Toggle word wrap

网格以 JSON 格式响应堆和非堆内存统计信息、直接内存用量以及有关内存池和垃圾收集的信息。

2.5.9. 获取 JVM 堆转储

使用 POST 请求为 Data Grid 服务器生成 JVM 堆转储。

POST /rest/v2/server/memory?action=heap-dump[&live=true|false]
Copy to Clipboard Toggle word wrap

Data Grid 在服务器数据目录中生成 HPROF 格式的堆转储文件,并使用 JSON 格式文件的完整路径进行响应。

2.5.10. 获取 JVM 线程转储

使用 GET 请求检索 JVM 的当前线程转储。

GET /rest/v2/server/threads
Copy to Clipboard Toggle word wrap

Data Grid 以 text/plain 格式通过当前线程转储进行响应。

2.5.11. 为 Data Grid 服务器获取诊断报告

使用 GET 请求检索 Data Grid 服务器的聚合报告。检索所请求服务器的报告:

GET /rest/v2/server/report
Copy to Clipboard Toggle word wrap

要检索集群中另一台服务器的报告,请按名称引用节点:

GET /rest/v2/server/report/{nodeName}
Copy to Clipboard Toggle word wrap

Data Grid 使用 tar.gz 存档进行响应,其中包含一个聚合的报告,其中包含有关 Data Grid Server 和主机的诊断信息。除了配置和日志文件外,报告还提供有关 CPU、内存、打开文件、网络套接字和路由、线程的详细信息。

2.5.12. 停止 Data Grid 服务器

使用 POST 请求停止 Data Grid 服务器。

POST /rest/v2/server?action=stop
Copy to Clipboard Toggle word wrap

网格以 204 (无内容) 响应,然后停止运行。

2.5.13. 检索客户端连接信息

使用 GET 请求列出与 Data Grid 服务器连接的客户端的信息。

GET /rest/v2/server/connections
Copy to Clipboard Toggle word wrap

Data Grid 以 JSON 格式响应所有活跃客户端连接的详情,如下例所示:

[
  {
    "id": 2,
    "name": "flower",
    "created": "2023-05-18T14:54:37.882566188Z",
    "principal": "admin",
    "local-address": "/127.0.0.1:11222",
    "remote-address": "/127.0.0.1:58230",
    "protocol-version": "RESP3",
    "client-library": null,
    "client-version": null,
    "ssl-application-protocol": "http/1.1",
    "ssl-cipher-suite": "TLS_AES_256_GCM_SHA384",
    "ssl-protocol": "TLSv1.3"
  },
  {
    "id": 0,
    "name": null,
    "created": "2023-05-18T14:54:07.727775875Z",
    "principal": "admin",
    "local-address": "/127.0.0.1:11222",
    "remote-address": "/127.0.0.1:35716",
    "protocol-version": "HTTP/1.1",
    "client-library": "Infinispan CLI 15.0.0-SNAPSHOT",
    "client-version": null,
    "ssl-application-protocol": "http/1.1",
    "ssl-cipher-suite": "TLS_AES_256_GCM_SHA384",
    "ssl-protocol": "TLSv1.3"
  }
]
Copy to Clipboard Toggle word wrap
Expand
表 2.36. 请求参数
参数必需/可选value

global

可选

true :将收集来自集群中所有服务器的连接

2.5.14. 为缓存配置检索默认值

使用 GET 请求检索缓存配置的默认值。

POST /rest/v2/server/caches/defaults
Copy to Clipboard Toggle word wrap

Data Grid 以 JSON 格式响应缓存配置的默认值。

Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat
返回顶部