Ignite无持久化内存缓存索引配置及get操作延迟排查

我们的应用启动时会从文件加载数据到Ignite缓存，API请求处理阶段从缓存验证数据。当前缓存的XML配置如下：

<bean class="org.apache.ignite.configuration.CacheConfiguration">
    <property name="name" value="AppMaster"/>
    <property name="cacheMode" value="PARTITIONED"/>
    <property name="atomicityMode" value="ATOMIC"/>
    <property name="queryEntities">
        <list>
            <bean class="org.apache.ignite.cache.QueryEntity">
                <property name="keyType" value="java.lang.String"/>
                <property name="valueType" value="java.util.HashMap"/>
                <property name="keyFieldName" value="keyId"/>
                <property name="keyFields">
                    <list>
                        <value>keyId</value>
                    </list>
                </property>
                <property name="fields">
                    <map>
                        <entry key="keyId" value="java.lang.String"/>
                    </map>
                </property>
                <property name="aliases">
                    <map>
                        <entry key="keyId" value="keyId"/>
                    </map>
                </property>
            </bean>
        </list>
    </property>
</bean>

遇到的问题 #

• 高负载下普通Key.get()操作耗时约200ms；
• 缓存为Key-Value结构，Value是HashMap对象；
• 在8核32GB虚拟机上，Stripe Pool保持默认8核配置，为何简单get操作响应时间过长？
• 已尝试设置IGNITE_QUIET=N，但仍无法定位延迟根因，该如何排查？

咨询问题 #

如何为无持久化存储的Ignite内存缓存配置索引？

性能延迟排查方案 #

1. 检查Stripe Pool负载与线程配置 #

默认8核的Stripe Pool在高负载下可能出现线程竞争。通过JMX监控IgniteMetrics下的stripePoolActiveThreads、stripePoolPendingTasks指标，若待处理任务持续堆积，说明线程数不足。可调整IgniteConfiguration中的stripedPoolSize（建议设为CPU核心数的1.5-2倍），同时检查publicThreadPoolSize是否足够处理非缓存操作。

2. 排查数据分布与网络开销 #

由于缓存是PARTITIONED模式，跨节点访问会增加延迟：

• 检查backups配置（当前默认0），无备份可能导致热点分区集中在少数节点，可设置1-2个备份分散负载；
• 用IgniteCache.localPeek(key)验证请求是否命中本地节点，若大量请求跨节点，可调整partitionCount（默认1024，建议增至4096）优化数据分布；
• 测试节点间网络带宽与延迟，排除网络波动导致的跨节点请求延迟。

3. 优化HashMap序列化开销 #

HashMap作为Value会带来额外的序列化/反序列化开销：

• 替换为自定义POJO类，减少序列化体积与耗时；
• 启用BinaryConfiguration的compactFooter=true和enableBasicTypes=true优化序列化逻辑；
• 监控IgniteMetrics中的binarySerializeTime指标，确认序列化是否为主要耗时点。

4. 高级排查手段 #

• 用jstack抓取线程栈，排查是否存在锁等待（如ReentrantLock.park()）或GC停顿；
• 启用Ignite性能统计：在配置中设置IgniteConfiguration.setPerformanceStatisticsEnabled(true)，通过ignite.performanceStatistics().print()输出操作细节耗时；
• 分析GC日志，用jstat或VisualVM查看GC频率与停顿时间，若GC耗时过长，调整JVM参数（如增大堆内存、改用G1GC）。

无持久化内存缓存的索引配置 #

无持久化的Ignite内存缓存索引完全存储在内存中，配置方式与持久化缓存一致，只需确保缓存为内存模式（默认MEMORY_ONLY，无需配置持久化）。

1. XML配置QueryEntity索引 #

在现有QueryEntity中添加indexes属性，为指定字段创建索引：

<bean class="org.apache.ignite.cache.QueryEntity">
    <!-- 原有配置保留 -->
    <property name="indexes">
        <list>
            <bean class="org.apache.ignite.cache.QueryIndex">
                <property name="name" value="keyId_unique_idx"/>
                <property name="type" value="UNIQUE"/>
                <property name="fields">
                    <map>
                        <entry key="keyId" value="ASC"/>
                    </map>
                </property>
            </bean>
        </list>
    </property>
</bean>

2. POJO注解配置索引 #

若后续替换HashMap为POJO类，直接在字段上添加@QuerySqlField注解：

public class AppMasterValue {
    @QuerySqlField(index = true, unique = true)
    private String keyId;
    // 其他业务字段
}

3. 运行时动态创建索引 #

如需在应用运行时添加索引，调用IgniteCache.createIndex()方法：

QueryIndex keyIdIdx = new QueryIndex();
keyIdIdx.setName("keyId_idx");
keyIdIdx.setType(QueryIndexType.UNIQUE);
keyIdIdx.addField("keyId", QueryIndexSortOrder.ASC);

ignite.cache("AppMaster").createIndex(keyIdIdx);

注意：无持久化缓存的索引会随节点重启丢失，需确保重启后重新加载数据时索引已正确创建。

内容的提问来源于stack exchange，提问作者Karthik_Rajendiran