Métriques Prometheus configurables HCL Cache

Bien que des modifications ne soient généralement pas requises, si vous intégrez à un système de surveillance tiers et qu'un coût est associé à l'extraction ou au stockage des métriques, ces configurations peuvent être utilisées pour affiner les métriques à utiliser.

Configuration du cache

Les métriques sont configurables au niveau du cache. Les modifications peuvent être appliquées à un seul cache ou à la configuration par défaut à l'aide de defaultCacheConfig. Pour plus de détails, voir Configuration du cache.

Activation ou désactivation des métriques pour un cache

Désactivez les métriques pour un cache à l'aide de l'attribut enabled comme suit :

  defaultCacheConfig:
    metrics:
      enabled: false

Périodes d'histogramme des métriques de minuteur

Les métriques Timer utilisées par le HCL Cache prennent en charge les histogrammes pour le calcul des centiles. Le suivi des valeurs d'histogramme requiert la définition de métriques supplémentaires. Cette prise en charge peut être désactivée pour réduire le nombre de métriques créées.

hclcache_cache_clears_total{cachespace="demoqaauth",name="baseCache",scope="local",} 100.0
hclcache_cache_clears_duration_seconds_sum{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",} 1.3296758
hclcache_cache_clears_duration_seconds_max{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",} 0.0897587
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="1.0E-4",} 0.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="3.0E-4",} 0.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="5.0E-4",} 0.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="7.0E-4",} 0.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="0.001",} 0.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="0.003",} 0.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="0.005",} 0.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="0.01",} 23.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="0.05",} 99.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="0.1",} 100.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="0.5",} 100.0
hclcache_cache_clears_duration_seconds_bucket{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",le="+Inf",} 100.0
hclcache_cache_clears_duration_seconds_count{cachespace="demoqaauth",name="baseCache",result="ok",scope="remote",} 100.0

La configuration d'histogramme par défaut est la suivante :

  defaultCacheConfig:
    metrics:
      timerNanoBuckets:
        - 100000 # 0.1 ms
        - 300000 # 0.3 ms
        - 500000 # 0.5 ms
        - 700000 # 0.7 ms
        - 1000000 # 1.0 ms
        - 3000000 # 3.0 ms
        - 5000000 # 5.0 ms
        - 10000000 # 10.0 ms
        - 50000000 # 50.0 ms
        - 100000000 # 100.0 ms
        - 500000000 # 500.0 ms

Les valeurs sont exprimées en nanosecondes.

Les périodes d'histogramme peuvent être désactivées en spécifiant une liste vide :

  defaultCacheConfig:
    metrics:
      timerNanoBuckets: []    

Si cette option est désactivée, les calculs de centiles ne seront plus disponibles dans le tableau de bord HCL Cache - Remote Grafana.

Utilisation de métriques communes pour tous les caches

  defaultCacheConfig:
    metrics:
      addCacheNameLabelToTimers: false