Probleemoplossing Data Collector

Het doel van deze gids is om te helpen bij het diagnosticeren en, in sommige gevallen, oplossen van problemen die kunnen ontstaan bij het uitvoeren van de Data Collector.

De onderstaande secties beantwoorden de meest gestelde vragen over de on-premise installatie van de Data Collector.

Is de Collection Manager ingelogd op de ITRS API? Copied

1. Op de machine waar de Data Collector is geïnstalleerd, start de Collection Manager door Capacity Planner Data Collector in te typen in de startbalk van Windows.
2. Controleer de linkerbenedenhoek van de statusbalk om er zeker van te zijn dat de Collection Manager is ingelogd op de ITRS API. Het zou het volgende moeten tonen:
   
   in plaats van een van de volgende:
   
   
3. Als de Collection Manager niet is ingelogd, klik dan op de statusbalk en log in op de API. Voor meer informatie, zie Inloggen op de ITRS API.

De verzameltaak kan niet inloggen op uw gegevensprovider Copied

Elke verzameltaak moet kunnen inloggen op de applicatie die gegevens over het systeem levert. Dit kan vCenter, Geneos, Dynatrace of een soortgelijk systeem zijn.

Als de inloggegevens voor de gegevensprovider zijn gewijzigd, moeten deze ook worden gewijzigd in de Data Collector taak.

1. Op de machine waar de Data Collector is geïnstalleerd, start de Collection Manager.
2. Markeer in de lijst met beschikbare taken de taak die faalt en klik op Edit Selected.
3. Controleer en corrigeer de verbindingsdetails voor de taak aan de rechterkant van het scherm.
4. Voer opnieuw de gebruikersnaam en het wachtwoord in in het gedeelte Windows Task Setup van het formulier.
5. Klik op Save om uw wijzigingen op te slaan.

De verzameltaak herhaalt niet Copied

Als de taak is ingesteld als een ad-hoc taak, dan kan deze alleen handmatig worden uitgevoerd, in plaats van op regelmatige basis te herhalen.

Om de frequentie van de taak te wijzigen, volg de stappen:

1. Op de machine waar de Data Collector is geïnstalleerd, start de Collection Manager.
2. Controleer in de lijst met taken of de kolom Repeat Every is ingesteld op 6 uur of 12 uur, zoals vereist.
   
3. Als de instelling Repeat Every onjuist is, selecteer dan de taak in de lijst en klik op Edit Selected.
   
4. In de taakeditor, verifieer dat het selectievakje Create scheduled task is geselecteerd, en dat geschikte parameters voor Start at en Repeat Every zijn ingevoerd.
5. Voer opnieuw de gebruikersnaam en het wachtwoord in voor de Windows taakgebruiker, en eventuele inloggegevens voor de gegevensprovider.
6. Klik op Save om uw wijzigingen op te slaan.

Bestaat er een overeenkomstige taak in de Windows Taakplanner? Copied

1. Op de machine waar de Data Collector is geïnstalleerd, open de Windows Taakplanner.
2. Breid het paneel Active Tasks onderaan het scherm uit.
3. Zoek de verzameltaak in de lijst op naam van de taak. U kunt door de lijst met actieve taken scrollen of de eerste drie letters van de taaknaam typen.
   
4. Dubbelklik op de taak om de instellingen te controleren.
5. Op het tabblad General, zorg ervoor dat Run whether user is logged on or not is aangevinkt.
6. Op het tabblad Triggers, controleer of er een dagelijkse trigger is, en dat de start- en herhalingsinstellingen zoals verwacht zijn.
7. In het tabblad Action, zorg ervoor dat de details specificeren om het commando RunCollection.exe te starten met de taaknaam van de geselecteerde taak als enige parameter. Bijvoorbeeld, in de onderstaande screenshot, is de naam van de verzameltaak Geneos-Prj335-at_13_0.
   
8. In het tabblad History, controleer of er foutmeldingen zijn, en stuur screenshots naar uw ITRS vertegenwoordiger als die er zijn.

Heeft de gebruiker die de geplande taak uitvoert voldoende rechten om deze uit te voeren? Copied

De gebruikersnaam die wordt opgegeven voor het uitvoeren van de geplande taak moet voldoende rechten hebben om een geplande taak uit te voeren, zelfs wanneer de gebruiker is uitgelogd.

De gebruiker heeft de volgende rechten nodig:

• Aanmelden als een batchtaak
• Aanmelden als een service
• Maptoegang om uit te voeren vanuit ...\Program Files\ITRS\Capacity Planner Data Collector.

To set up or verify user permissions, follow these steps:

1. Open the local security policy window from the Windows start menu by typing:

secpol.msc

2. From the Security Settings menu, select Local Policies > User Rights Assignment.
3. Double click the Log on as a batch job policy in the right-hand list.
4. Click Add User or Group to open theSelect User, Computers, Service Accounts or Groups dialog box.
5. Click the Locations button and select the local machine from the list.
6. Enter the new user name as the object name and click Check Names to add it.
7. Click OK and close other windows.
8. Repeat the steps for the Log on as a service policy.
   

Wachten er bestanden op upload? Copied

Wanneer verzameltaken zijn voltooid, slaan ze de gegevens op die moeten worden geüpload in de volgende map: C:\Users\<username>\AppData\Local\Temp\ITRS\UploadQueue\Data.

• Als de taak handmatig is uitgevoerd vanuit de Collection Manager, dan is de gebruikersnaam de momenteel ingelogde gebruiker.
• Als de taak is uitgevoerd als een geplande taak, dan is de gebruikersnaam de gebruiker die de geplande taak uitvoert.

Wanneer geplande taken zijn uitgevoerd, worden de resultaten gezipt in een submap met dezelfde naam als de taaknaam. Deze bestanden worden automatisch verwijderd zodra ze zijn geüpload naar de ITRS API.

Als er bestanden aanwezig zijn in de uploadwachtrij, dan geeft dit aan dat de verzameltaak succesvol is uitgevoerd, en dat er een probleem is met de API-upload.

Zip-bestandsnamen bevatten de start- en einddatums, en tijden van de verzameling, in het volgende formaat: JaarMaandDag_UurMinuutSeconde.

Voorbeeld: Een zipbestand Geneos_ITRSScotland (20200218_092717 tot 20200219_092717).zip werd gegenereerd voor de taak Geneos_ITRSScotland die liep van 09:27 op 18th Feb 2020 tot 09:27 op 19th Feb 2020.

Waar kan ik foutenlogboeken van de Data Collector vinden? Copied

De Data Collector schrijft foutenlogboeken naar de volgende map: C:\Program Files\ITRS\Capacity Planner Data Collector\Logs.

Deze worden normaal gesproken geüpload naar de ITRS-remote website om te helpen bij het diagnosticeren van fouten. Echter, als de Data Collector geen verbinding kan maken met de ITRS API, dan moeten de verzamellogs via een alternatieve route worden verzonden.

De map met logbestanden kan worden bereikt via Windows Verkenner, of door op de View Logs-knop op het Collection Manager-scherm te klikken.

API-certificatieproblemen Copied

Als de SSL-certificatie niet correct is geconfigureerd voor de ITRS API, dan zal de Data Collector niet inloggen en gegevens uploaden.

Een probleem met SSL wordt aangegeven door de volgende regel die verschijnt in de foutenlogboeken van de Data Collector:

ERROR WebException raised during login: TrustFailure: The underlying connection was closed: Could not establish trust relationship for the SSL/TLS secure channel.

Om te controleren, open Internet Explorer en voer de API URL https://icp-api.itrsgroup.com/ in

Als de site niet vertrouwd is, dan zal de achtergrond van de adresbalk veranderen naar roze, en kan er een foutmelding over een niet-vertrouwd certificaat verschijnen:

De Sumerian API vereist dat een SSL-certificaat is geïnstalleerd om de veilige levering van verzamelde gegevens te garanderen. Raadpleeg uw IT-afdeling voordat u certificaten installeert.

Installeer een certificaat Copied

Als u bevoegd bent om een certificaat te installeren, volg dan de stappen:

1. Klik op de foutmelding in de adresbalk en klik op View Certificates.
   Als alternatief, klik met de rechtermuisknop op de webpagina en selecteer Properties, en klik dan op Certificates in de rechter benedenhoek.
   
2. Selecteer de optie om Install the Certificate te kiezen, en sluit dan de browser en open hem opnieuw.
3. Ga terug naar de https://icp-api.itrsgroup.com/ site om te verifiëren dat de certificaatfout is verdwenen
4. Herstart de Data Collector en probeer opnieuw in te loggen.

SSL over proxyverbindingen Copied

Als u toegang krijgt tot de API via een proxyverbinding, moet u mogelijk het certificaat ook op de proxyserver installeren. Doe dit door een extern bureaublad op de proxyserver te openen en de stappen in Installeer een certificaat te herhalen.

Als de proxyserver ook een SSL-certificaat gebruikt, zorg er dan voor dat de server die de Data Collector uitvoert ook het SSL-certificaat van de proxyserver geïnstalleerd heeft.

Aanvullende SSL-problemen Copied

De Trusted Root Certification Authority voor de Sumerian API is Comodo. Voor het API SSL-certificaat om erkend te worden, moet de server waarop de Data Collector draait het Comodo rootcertificaat in zijn vertrouwde rootcertificaatopslag hebben.

1. Voer certmgr.msc uit vanaf de taakbalk op de betreffende Windows-machine.
2. Wanneer de manager opent, vouw de Trusted Root Certification Authority > Certificates-map uit en controleer of er een vermelding voor COMODO RSA Certification Authority in de lijst staat.
3. Controleer of de vervaldatum correct is.
4. Als er discrepanties zijn, neem dan contact op met uw IT-afdeling.

Het SSL-certificaat werkt alleen op verbindingen die gebruik maken van TLS-versies hoger dan 1.0. Om dat te verifiëren, volg de stappen:

1. Open Internet Explorer.
2. Navigeer naar https://icp-api.itrsgroup.com/.
3. Klik met de rechtermuisknop ergens op de pagina en selecteer eigenschappen.
4. Controleer of de TLS-versie in het veld Connection hoger is dan 1.0.
   Als dit niet het geval is, neem dan contact op met uw IT-afdeling.