Naslag Voor: beheerders, gebruikers, ontwikkelaars

Fouten in prestatiegegevens

Oorzaken en oplossingen voor de foutcodes van prestatiegrafieken, metriekquery's en het opnemen van samples.

error.metrics_disabled

Tekst in de console
Prestatiegegevens zijn uitgeschakeld. De beheerservice draait met uitgeschakelde prestatiemetingen. Vraag een beheerder om ze in te schakelen in de configuratie van de controller.
Betekenis voor API-clients
Performance metrics are turned off on the controller.
Code
UNAVAILABLE, HTTP 503

Oorzaak. Prestatiemetriek is uitgeschakeld op de controller, zodat grafieken en het verbruiksregister geen gegevens kunnen leveren. De instelling is performance in de sectie [metrics] van de controllerconfiguratie.

Oplossing.

  1. Een beheerder zet performance = true in de sectie [metrics] van de controllerconfiguratie en start de controller opnieuw. De waarde is standaard true, dus de instelling is met opzet gewijzigd.
  2. Geef de bericht-id error.metrics_disabled door wanneer u de configuratie zelf niet kunt wijzigen.

error.metrics_bad_entity

Tekst in de console
Voor dit object worden geen prestatiegegevens bewaard. Alleen hosts, virtuele machines en datastores hebben grafieken. Open een van die objecten.
Betekenis voor API-clients
No performance data is kept for that object kind.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentInhoud
entityde id die is geweigerd.

Oorzaak. De aanvraag vraagt prestatiegegevens van een objectsoort die er geen heeft. Alleen hosts, virtuele machines en datastores hebben prestatiegegevens.

Oplossing.

  1. Open een host, een virtuele machine of een datastore en gebruik de prestatieweergave ervan.
  2. Geef met de CLI de id van een van die objecten op: kyvernon metrics available <entity>.

error.metrics_bad_interval

Tekst in de console
De periode is niet beschikbaar. De beheerservice bewaart metingen per 20 s, 5 min, 30 min, 2 uur en 1 dag. Kies een van de vermelde perioden.
Betekenis voor API-clients
Not a supported sampling period.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentInhoud
intervalde geweigerde periode in seconden.

Oorzaak. De bemonsteringsperiode is er geen die Kyvernon bewaart. De perioden zijn 20 seconden, 5 minuten, 30 minuten, 2 uur en 1 dag.

Oplossing.

  1. Kies een van de genoemde perioden. Kies in de console een tijdbereik met Periode.
  2. Toon de perioden met de CLI: kyvernon metrics intervals.

error.metrics_unknown_counter

Tekst in de console
Een gevraagde teller bestaat niet. De beheerservice draait mogelijk een oudere versie. Werk de beheerservice bij of laad de pagina opnieuw.
Betekenis voor API-clients
No such counter.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentInhoud
counterde naam of id die is geweigerd.

Oorzaak. De aanvraag noemt een teller die de controller niet kent. De naam bevat een typefout, of de console of het script is nieuwer dan de controller.

Oplossing.

  1. Toon de tellers die de controller kent: kyvernon metrics counters.
  2. Gebruik een naam of een id uit die lijst.
  3. Is de console nieuwer dan de controller, werk dan de controller bij of laad de pagina opnieuw.

error.metrics_query_empty

Tekst in de console
Het verzoek bevatte geen object of teller. Laad de pagina opnieuw en probeer het nogmaals.
Betekenis voor API-clients
The query names no entity or counter.
Code
INVALID_ARGUMENT, HTTP 400

Oorzaak. De query noemt geen object of geen teller. Een query heeft van elk minstens één nodig.

Oplossing.

  1. Geef minstens één entiteit en één teller op: kyvernon metrics query --entity <id> --counter <name>.
  2. Laad in de console de pagina opnieuw en probeer het nog eens.

error.metrics_query_too_large

Tekst in de console
Het verzoek omvat te veel metingen. Een query levert maximaal 200.000 punten op. Kies een kortere periode of minder apparaten.
Betekenis voor API-clients
The query would return too many samples.
Code
INVALID_ARGUMENT, HTTP 400

Oorzaak. De query vraagt te veel. Een query noemt hoogstens 100 entiteiten en 100 tellers en levert hoogstens 200.000 samples op.

Oplossing.

  1. Kies een korter tijdbereik, een langere bemonsteringsperiode of minder objecten. kyvernon metrics query accepteert --start, --end, --interval en --max-samples.
  2. Splits de query in meerdere kleinere.

error.metrics_too_many_batches

Tekst in de console
Een hostagent stuurde in één rapport meer dan {max} metingbatches, waardoor het hele rapport is geweigerd. Werk de hostagent bij of neem contact op met de ondersteuning als de agent actueel is.
Betekenis voor API-clients
A host agent sent more than max metric batches in one report; the whole report is rejected.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentInhoud
maxhet grootste aantal batches dat de controller in één rapport aanvaardt.

Oorzaak. Een hostagent stuurde in één rapport meer dan max samplebatches (16), waarna de controller het hele rapport weigerde. Er is niets mis met de metingenservice. Gebruikers van de console veroorzaken deze fout niet; ze betreft de verbinding tussen een hostagent en de controller.

Oplossing.

  1. Werk de hostagent bij naar de versie van de controller. Beide komen uit dezelfde release.
  2. Blijft de fout bestaan, dan leest een beheerder de logs van de controller en de hostagent. Geef de bericht-id en de naam van de host door.

Versie 0.1. Laatst gewijzigd: 2026-11-13