Externe opslagplaats voor Resource Monitoring Tool van Tableau
De Resource Monitoring Tool van Tableau gebruikt een PostgreSQL-database als opslagplaats voor het verzamelen en opslaan van data over Tableau Server-bewaking. Deze wordt gebruikt om informatie over prestaties en gebruik te verstrekken. Deze database is gescheiden van de Tableau Server-database.
Vóór de release van 2022.3 werd deze PostgreSQL-opslagplaats automatisch geïnstalleerd met de RMT Server, op dezelfde machine als de RMT Server. Dit was de enige beschikbare optie. Vanaf versie 2022.3 kunt u RMT Server opnieuw configureren om een extern gehoste PostgreSQL-database te gebruiken in plaats van de lokaal geïnstalleerde database. Wanneer RMT Server is geconfigureerd voor gebruik van extern gehoste PostgreSQL-database, noemen we dit de externe opslagplaats.
Het ondersteunde platform voor het hosten van de externe opslagplaats is een AWS RDS-exemplaar. Door de database van de opslagplaats extern te hosten, kunt u de beschikbaarheid, back-ups en noodherstel van de opslagplaats van de RMT Server beheren.
Door het toevoegen van deze optie om een externe opslagplaats te configureren, kan RMT Server op de volgende manieren worden geconfigureerd:
De lokaal geïnstalleerde opslagplaats blijven gebruiken: dit betekent dat de PostgreSQL-database die automatisch met RMT Server op dezelfde computer wordt geïnstalleerd, wordt gebruikt als opslagplaats voor RMT Server en dat er geen verdere wijzigingen in deze configuratie worden aangebracht.
RMT Server configureren om een externe opslagplaats te gebruiken: dit betekent dat de PostgreSQL-database die RMT gebruikt, extern ten opzichte van RMT Server wordt gehost. Hiervoor moeten na de installatie enkele configuratiewijzigingen worden doorgevoerd. Momenteel worden alleen AWS RDS-exemplaren ondersteund als hostingplatform voor PostgreSQL-databases.
Om de externe opslagplaats in te stellen en te beheren, moet u goede kennis hebben van het AWS RDS-platform en de PostgreSQL-database. We raden u aan om de documentatie op de AWS-site te gebruiken voor aan platforms gerelateerde instructies.
U moet ook weten hoe u de externe opslagplaats configureert en beheert voor Resource Monitoring Tool. In dit onderwerp vindt u de informatie hierover in de onderstaande secties.
Nieuwe installatie van Resource Monitoring Tool
De instructies in dit deel zijn van toepassing op een nieuwe installatie van Resource Monitoring Tool. Als u een bestaande implementatie van RMT hebt en wilt overstappen naar een configuratie voor een externe opslagplaats, raadpleegt u het deel Bestaande Resource Monitoring Tool-installatie van dit onderwerp.
Wanneer u RMT Server installeert, wordt de database van de opslagplaats automatisch op dezelfde computer geïnstalleerd als de RMT Server. Het proces voor het configureren van de externe opslagplaats is een configuratie na de installatie. Hierbij configureert u RMT Server opnieuw voor gebruik van een extern gehoste PostgreSQL-database.
Gebruik de volgende stappen om Resource Monitoring Tool te installeren en RMT Server opnieuw configureren voor gebruik van een externe opslagplaats:
De externe opslagplaats maken: maak een RDS-exemplaar om de externe opslagplaats te hosten met de volgende aanbevelingen.
Aanbevolen minimale specificaties voor PostgreSQL-exemplaren:
db.m6g.2xlarge (8 vcpu, 32 GiB RAM)
SSD-opslag met 500 GB schijfruimte
- Waarden voor configuratie van exemplaar:
Max. workerprocessen: totaal aantal logische processoren
Max. workers per verzameling: min, (totaal aantal logische processoren / 2, 4)
Max. parallel workers: totaal aantal logische processoren
Max. parallelle onderhoudsworkers: min. (totaal aantal logische processoren / 2, 4)
Gedeelde buffers: totaal geheugen / 4
Effectieve cachegrootte: 75% van het totale geheugen
Geheugen voor onderhoudswerk: totaal geheugen / 16 Linux, max. 2 GB, 1 MB in Windows
Wal buffers: Afgeleid van gedeelde buffers, waarschijnlijk rond de 16 MB
Werkgeheugen: afgeleid van gedeelde buffers en max. workers per verzameling
Zie deze pagina op de AWS-documentatiesite voor meer informatie over het maken en verbinden van een PostgreSQL Db-exemplaar op AWS.
RMT installeren: volg de instructies De RMT-server installeren via de opdrachtregel om RMT Server te installeren, maar: sla de stappen voor het aanmaken van een omgeving over. U doet dit later nadat u RMT Server hebt geconfigureerd om de externe opslagplaats te gebruiken. Houd er rekening mee dat hiermee in eerste instantie een lokale PostgreSQL-database wordt geïnstalleerd.
De verbinding met de externe opslagplaats testen: test de verbinding met de nieuwe database met psql. Dit is een PostgreSQL-beheerprogramma dat samen met de RMT-server is geïnstalleerd;
Ga naar de map 'bin' van de lokaal geïnstalleerde PostgreSQL-installatiedirectory.
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql<version number>\bin
Voer de volgende opdracht uit om de verbinding te testen: Vervang hieronder uw eigen waarde door aws_rds_servernaam. Geef het PostgreSQL-wachtwoord op dat u in AWS hebt gemaakt wanneer u daarom wordt gevraagd.
.
\psql.exe -h <aws_rds_servername> -p 5432 -d postgres -U postgres
Als u op dit punt een foutmelding krijgt en geen verbinding kunt maken, controleer dan de parameterwaarden in de opdracht met de waarden in de AWS RDS-console.
Zodra de verbinding met succes tot stand is gebracht, kunt u de psql-sessie sluiten met de volgende opdracht:
\q
Voer
rmtadmin master-setup
uit om RMT Server te configureren voor gebruik van de externe opslagplaats. Gebruik de volgende opdrachtvoorbeelden en bewerk de opdracht om deze aan te passen aan uw wensen. Resource Monitoring Tool installatiepad, naam van AWS RDS-exemplaar, poortnummer en het RDS PostgreSQL-beheerderswachtwoord:Ga naar de Resource Monitoring Tool RMT Server-installatiedirectory:
cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'
Voer de opdracht uit om een externe opslagplaats te configureren:
./rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-database=<aws_rds_database_name> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>
Maak nu een omgeving en download het bootstrap-bestand:
Voer de volgende opdracht uit om een omgeving te maken:
rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>
Download het bootstrap-bestand om agents te registreren:
rmtadmin bootstrap-file --env=<myenvironment> --filename=<The absolute or relative path including the file name>
De stappen worden hier uitgebreid beschreven: De RMT-server installeren via de opdrachtregel.
Volg de instructies De agent installeren via de opdrachtregel om agents te installeren en registreren op Tableau Server-knooppunten.
Bestaande Resource Monitoring Tool-installatie
Er zijn twee manieren om bestaande RMT-installaties die momenteel een lokale opslagplaats gebruiken, te migreren naar een externe opslagplaats. Het pad dat u kiest, is afhankelijk van de grootte en complexiteit van uw omgeving.
Migratie met opnieuw aanmaken in de omgeving: dit is geschikt voor RMT-installaties met een kleine omgeving met weinig configuratie en waarschuwingen, omdat bij dit pad de omgeving opnieuw moet worden gemaakt en opnieuw moet worden begonnen. Hierbij gaan de tot dan toe verzamelde data verloren.
Hiervoor moet de RMT-server opnieuw worden geconfigureerd voor gebruik van een externe opslagplaats, moeten de omgevingen opnieuw worden gemaakt en moeten alle aangepaste configuraties, zoals drempelwaarden voor incidenten, opnieuw worden uitgevoerd en moeten de agents opnieuw worden geregistreerd. Dit lijkt erg op het uitvoeren van een nieuwe installatie van RMT zoals beschreven in het bovenstaande gedeelte. Behalve dat u in dit geval RMT niet installeert.
Handmatige migratie met minimaal dataverlies: dit is speciaal bedoeld voor klanten met grote en complexe omgevingen die niet helemaal opnieuw willen beginnen. Deze migratie is handmatig en geen ingebouwde migratiefunctie voor RMT. Hieronder vindt u de instructies om dit te doen:
Handmatig lokale migratie uitvoeren voor Resource Monitoring Tool-opslagplaats naar een extern AWS PostgreSQL DB-exemplaar
Stap 1: een RDS-exemplaar maken om de externe opslagplaats te hosten
Gebruik de volgende aanbevelingen bij het maken van het nieuwe RDS-exemplaar:
Aanbevolen minimale specificaties voor PostgreSQL-exemplaren:
db.m6g.2xlarge (8 vcpu, 32 GiB RAM)
SSD-opslag met 500 GB schijfruimte
- Waarden voor configuratie van exemplaar:
Max. workerprocessen: totaal aantal logische processoren
Max. workers per verzameling: min, (totaal aantal logische processoren / 2, 4)
Max. parallel workers: totaal aantal logische processoren
Max. parallelle onderhoudsworkers: min. (totaal aantal logische processoren / 2, 4)
Gedeelde buffers: totaal geheugen / 4
Effectieve cachegrootte: 75% van het totale geheugen
Geheugen voor onderhoudswerk: totaal geheugen / 16 Linux, max. 2 GB, 1 MB in Windows
Wal buffers: Afgeleid van gedeelde buffers, waarschijnlijk rond de 16 MB
Werkgeheugen: afgeleid van gedeelde buffers en max. workers per verzameling
Zie deze pagina op de AWS-documentatiesite voor meer informatie over het maken en verbinden van een PostgreSQL Db-exemplaar op AWS.
Stap 2: testen of u verbinding kunt maken met de nieuwe database
Test de verbinding met de nieuwe database met psql. Dit is een PostgreSQL-beheerprogramma dat bij RMT Server wordt geleverd. Vervang hieronder uw eigen waarde door aws_rds_servernaam. Geef het PostgreSQL-wachtwoord op dat u in AWS hebt gemaakt wanneer u daarom wordt gevraagd.
Ga naar de map 'bin' van de lokaal geïnstalleerde PostgreSQL-installatiedirectory.
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql<version number>\bin
Voer de volgende opdracht uit om de verbinding te testen: Vervang hieronder uw eigen waarde door aws_rds_servernaam. Geef het PostgreSQL-wachtwoord op dat u in AWS hebt gemaakt wanneer u daarom wordt gevraagd.
.
\psql.exe -h <aws_rds_servername> -p 5432 -d postgres -U postgres
Als u op dit punt een foutmelding krijgt en geen verbinding kunt maken, controleer dan de parameterwaarden in de opdracht met de waarden in de AWS RDS-console.
Zodra de verbinding met succes tot stand is gebracht, kunt u de psql-sessie sluiten met de volgende opdracht:
\q
Stap 3: het beheerderswachtwoord verkrijgen voor de lokale PostgreSQL-database die momenteel door RMT wordt gebruikt
Voer de volgende opdrachten uit om het beheerderswachtwoord uit de lokale opslagplaats op te halen. Dit is nodig om een back-up te maken van de data in uw lokale opslagplaats voordat u de migratie uitvoert.
Ga naar de installatiemap van RMT Server:
cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'
Ontvang het beheerderswachtwoord:
rmtadmin get db.adminPassword
Stap 4: een back-up maken van de bestaande PostgreSQL-databaseStop eerst RMT ter voorbereiding op het maken van een databaseback-up:
rmtadmin stop
Start nu alleen de DB-service opnieuw op, zodat u een back-up kunt maken:
rmtadmin start -db
- Gebruik de volgende voorbeeldscripts en vervang het bestandspad door uw eigen waarden. Als u de poort hebt aangepast, werk deze dan ook bij. Geef het wachtwoord uit de vorige stap op wanneer daarom wordt gevraagd:
Ga naar de bin-map van de lokale opslagplaats:
cd 'C:\Program Files\Tableau\Tableau Resource Monitoring Tool\prerequisites\postgresql<version number>\bin'
Maak een back-up:
pg_dump -f your_file_name.dump -F d -j 10 -Z 5 -d tabrmt -h localhost -p 5555 -U postgres
-F d
: voer een archief uit in directory-opmaak dat geschikt is voor invoer in pg_restore-j 10
: voer de back-up parallel uit door van 10 tabellen tegelijkertijd een back-up te maken-Z 5
: geef het te gebruiken compressieniveau op
Opmerking: data die door Resource Monitoring Tool zijn verzameld in de tijd tussen deze stap en de laatste stap, worden niet bewaard nadat de migratie is voltooid.
Stap 5: RMT Server configureren om naar de externe opslagplaats te verwijzen
Start alle RMT-services opnieuw:
rmtadmin restart --all
Gebruik de volgende opdracht als voorbeeld. Bewerk de opdracht zodat de RDS-servernaam, databasenaam, de poort en het RDS Postgres-gebruikerswachtwoord worden weergegeven.
Ga naar de installatiemap van RMT Server:
cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'
Configureer de externe opslagplaats:
rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-database=<aws_rds_database_name> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>
Stap 6: de back-up herstellen naar de externe opslagplaats
Stop eerst RMT Server:
rmtadmin stop
Herstel de back-up die u in stap 4 hebt gemaakt naar het nieuwe AWS RDS PostgreSQL-exemplaar. Bewerk het onderstaande voorbeeldscript zodat het de naam en poort van uw AWS RDS-server weergeeft. Zorg dat het pad en de naam van het dumpbestand correct zijn. Wanneer u daarom wordt gevraagd, geeft u het wachtwoord voor de gebruiker 'postgres' op in RDS.
pg_restore -j 5 -c -h <aws_rds_servername> -p 5432 -U postgres -d tabrmt <your_file_name>.dump
-j 5
: voer het herstel parallel uit door 5 tabellen tegelijk te herstellen-c
: database-objecten opschonen (verwijderen) voordat u ze opnieuw aanmaakt
Stap 7: de identiteitsmigratie starten
rmtadmin start
Stap 8: agents opnieuw registreren
Zodra de servicewijzigingen zijn uitgevoerd, start u elke agent opnieuw op en registreert u deze opnieuw via de webinterface. Volg hiervoor de onderstaande stappen.
Download een nieuw bootstrap-bestand van RMT Server.
Ga naar http://localhost:9002/setup/register om de webinterface van de agent te openen en importeer de bootstrap.
Klik op Berichtenwachtrij testen. Controleer de vorige invoer als u een foutmelding krijgt.
Klik op Verbinden met berichtenwachtrij.
Klik in het gedeelte Server op de vervolgkeuzelijst met vooraf geselecteerde 'Nieuwe omgevingsserver'. In plaats van de standaardinstelling te accepteren, kiest u de server die u probeert te registreren uit de lijst. Ga naar beneden en klik op de knop ‘Agent registreren’.
Zie De agent installeren via de opdrachtregel voor meer informatie of het registreren van agents.
Stap 9: controleren of de RMT-server actief is en of u de historische data ziet
Meld u aan bij RMT Server en controleer of er oudere data aanwezig zijn en of nieuwe data worden verwerkt. Controleer ook eventuele aangepaste configuratie-instellingen om er zeker van te zijn dat alles correct is gemigreerd.
Best practices bijwerken
Dit zijn de algemene stappen die u moet volgen als u Tableau Resource Monitoring Tool wilt upgraden en tegelijkertijd naar een externe opslagplaats wilt migreren:
Migratie met opnieuw aanmaken in de omgeving:
Upgrade RMT Server en alle agents naar 2022.3 of later.
- Stappen 2-4 lijken erg op de stappen die u zou nemen om een nieuwe installatie uit te voeren. Zie Nieuwe installatie van Resource Monitoring Tool hierboven. Het gaat hierbij vooral om:
Een AWS PostgreSQL Db-exemplaar maken.
RMT Server configureren om de externe opslagplaats te gebruiken.
Omgevingen opnieuw aanmaken en alle agents opnieuw registreren.
Eventuele aangepaste configuraties opnieuw configureren.
Opmerking: u verliest historische data en moet bovendien eventuele aangepaste configuraties opnieuw configureren.
Handmatige migratie met minimaal dataverlies:
Upgrade RMT Server en alle agents naar versie 2022.3 of later.
- Volg de stappen die in het deel Migratie. Het gaat hierbij vooral om:
Een AWS PostgreSQL Db-exemplaar maken.
Een-back-up maken van de PostgreSQL-configuratie.
RMT Server configureren voor gebruik van de externe opslagplaats (PostgreSQL DB-instantie).
Zet de back-up terug naar de externe opslagplaats. Registreer de agents opnieuw.
Agents opnieuw registreren.
Upgraden wanneer de nieuwe versie van RMT een grote PostgreSQL-versie-upgrade vereist
Wanneer er een wijziging is in de vereiste voor de PostgreSQL-hoofdversie voor Resource Monitoring Tool, is het een beste werkwijze om eerst de externe PostgreSQL-versie van de opslagplaats te upgraden voordat u een upgrade uitvoert voor Resource Monitoring Tool. Meer details vindt u hieronder. Om te zien of u uw externe PostgreSQL-versie moet upgraden, raadpleegt u de tabel voor Productcompatibiliteit.
Gebruik de volgende stappen om RMT en het RDS-exemplaar te upgraden wanneer een upgrade voor de PostgreSQL-hoofdversie vereist is
Maak een back-up van uw RDS-exemplaar. U hebt deze back-up nodig als u de upgrade wilt terugdraaien. Zie het onderwerp Back-up maken en herstel van een Amazon RDS DB-exemplaar op de AWS-site voor meer informatie.
Maak een kopie van het configuratiebestand in de directoryResource Monitoring Tool. Het configuratiebestand bevindt zich op:
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.json
Werk het RDS-exemplaar bij naar de nieuwe versie van PostgreSQL. Zie het onderwerp Upgraden van de PostgreSQL DB-engine voor Amazon RDS op de AWS-site voor meer informatie.
RMT Server upgraden. Als de upgrade, inclusief de databasemigratie, is voltooid, gaat u verder met de volgende stap. Als de upgrade mislukt, raadpleeg dan de instructies in dit gedeelte over hoe u de upgrade kunt herstellen en terugdraaien.
Upgrade alle agents op Tableau Server-knooppunten naar de nieuwe RMT-versie. Zie Resource Monitoring Tool upgraden voor meer informatie.
Herstellen van een mislukte upgrade
Verwijder de RMT-server waarvoor een upgrade is uitgevoerd.
Herstel het AWS RDS-exemplaar naar de versie van vóór de upgrade. Zie het onderwerp Back-up maken en herstellen van een Amazon RDS DB-exemplaar op de AWS-site voor meer informatie.
Vervang het configuratiebestand waarvan u vóór de upgrade een back-up hebt gemaakt op de volgende locatie. Mogelijk moet u deze map aanmaken, omdat deze mogelijk is verwijderd tijdens het verwijderen:
C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config.json
Installeer RMT Server, waarbij een lokale opslagplaats wordt geïnstalleerd.
Configureer RMT Server om de externe opslagplaats te gebruiken:
rmtadmin master-setup --db-config=external --db-server=<aws_rds_servername> --db-database=<aws_rds_database_name> --db-port=5432 --db-admin-username=postgres --db-admin-password=<postgres_user_password>
Compatibiliteit van RMT- en PostgreSQL-versies
In deze tabel worden alleen RMT-versie 2022.3 en later weergegeven, omdat externe opslagplaatsen alleen beschikbaar zijn vanaf versie 2022.3 en later.
RMT-versie | PostgreSQL-versie meegeleverd met RMT | Ondersteunde PostgreSQL-versie voor externe opslagplaats |
2022.3 - 2024.2 | 13.7 | 13.7 |
Wie kan dit doen
Om Resource Monitoring Tool te installeren, moet u over het volgende beschikken:
- Beheerdersrechten op de computer waarop u Resource Monitoring Tool installeert.
- Siterol van Tableau Server-beheerder.
- Beheerdersaccount voor Resource Monitoring Tool.