Externe berichtenwachtrijservice (RabbitMQ) voor Resource Monitoring Tool van Tableau
De Resource Monitoring Tool van Tableau gebruikt RabbitMQ als berichtenwachtrijservice om data van agents te verzamelen en naar de RMT-server over te zetten. Deze informatie in de wachtrij wordt verwerkt en uiteindelijk opgeslagen in de RMT-opslagplaats (PostgreSQL-database).
Vóór de release van 2022.3 werd de RabbitMQ-berichtenwachtrijservice automatisch geïnstalleerd met de RMT-server en was dit de enige beschikbare configuratie. Vanaf RMT versie 2022.3 kunt u RMT Server opnieuw configureren voor gebruik van een extern gehoste RabbitMQ-service. Wanneer RMT Server is geconfigureerd voor een extern gehoste berichtenwachtrijservice, noemen we dit de externe berichtenwachtrijservice.
Met deze nieuwe optie, toegevoegd in versie 2022.3, kan RMT Server op de volgende manieren worden geconfigureerd:
- De lokaal geïnstalleerde berichtenwachtrijservice blijven gebruiken: dit betekent dat RabbitMQ, dat automatisch met RMT Server op dezelfde computer wordt geïnstalleerd, wordt gebruikt als berichtenservice voor de RMT Server en dat er geen verdere wijzigingen in deze configuratie worden aangebracht.
- RMT Server configureren om een externe berichtenwachtrijservice te gebruiken: dit betekent dat RabbitMQ dat RMT gebruikt, extern ten opzichte van RMT Server wordt gehost. Momenteel wordt AWS AMQ alleen ondersteund als hostingplatform voor RabbitMQ. Omdat alle berichten van de agents via RabbitMQ verlopen, komen er door het extern hosten bronnen vrij op de computer waarop RMT Server is geïnstalleerd.
Om de externe berichtenwachtrijservice in te stellen en te beheren, moet u een goed begrip hebben van het AWS AMQ-platform. We raden aan om de documentatie op de AWS-site door te nemen. U moet ook weten hoe u de externe berichtenwachtrijservice voor RMT configureert en beheert. In dit onderwerp vindt u de informatie hierover in de onderstaande secties.
Nieuwe installatie van Resource Monitoring Tool
De instructies in dit gedeelte zijn van toepassing op een nieuwe installatie van Resource Monitoring Tool. Als u een bestaande installatie hebt en uw lokale RabbitMQ wilt verplaatsen naar een extern gehoste configuratie, raadpleeg dan het gedeelte Bestaande installaties van Resource Monitoring Tool van Tableau van dit onderwerp.
Gebruik de volgende stappen om de Tableau Resource Monitoring Tool te installeren en RMT Server opnieuw te configureren voor gebruik van een externe berichtenwachtrijservice:
Amazon AMQ maken voor Rabbit MQ om de externe berichtenwachtrijservice te hosten met de volgende aanbevelingen:
Gebruik de RabbitMQ-engine als engine-type. Zie het gedeelte Productcompatibiliteit voor de versie van Rabbit MQ.
Gebruik dezelfde standaardversie als die voor de lokale installatie van RabbitMQ. Zie de compatibiliteitstabel voor meer informatie.
Gebruik een single-instance broker.
Specificatie van exemplaar: mq.m5.large, 2 vCPU/8 GiB RAM.
Maak een RabbitMQ-gebruikersnaam/-wachtwoord aan.
Zie Werken met Amazon MQ voor Rabbit MQ op de AWS-documentatiesite voor meer informatie.
De verbinding testen vanaf de RMT-server naar de berichtenbroker door de URL van de RabbitMQ-webconsole van de AWS MQ-pagina te kopiëren en deze in een webbrowser op de RMT-server te plakken. Log in met de gebruikersnaam en het wachtwoord dat/die u hebt aangemaakt bij het instellen van de broker.
Volg de instructies in dit onderwerp voor RMT-server 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.
Voer rmtadmin setup als volgt uit om de externe Rabbit MQ-berichtenwachtrijservice te configureren:
rmtadmin master-setup --mq-config=external --mq-server=aws_amq_servername --mq-vhost='/' --mq-port=5671 --mq-username=aws_amq_username --mq-password='aws_amq_password' --mq-tls-certificate-host=aws_amq_servername
Maak nu een omgeving aan 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 uitgebreid beschreven in het onderwerp De RMT-server installeren via de opdrachtregel.
Registreer agents opnieuw op Tableau Server-knooppunten met de instructies in het onderwerp De agent installeren via de opdrachtregel.
Bestaande installaties van Resource Monitoring Tool van Tableau
Er zijn twee manieren om een bestaande RMT-installatie die momenteel een lokale berichtenwachtrijservice gebruikt, te migreren naar een externe berichtenwachtrijservice:
Migratie met opnieuw aanmaken in de omgeving: dit omvat het maken van de externe Rabbit MQ-service, het configureren van RMT Server voor gebruik van de externe berichtenwachtrijservice, het opnieuw maken van de omgevingen en het opnieuw uitvoeren van alle aangepaste configuraties, zoals drempelwaarden voor incidenten en het opnieuw registreren van de agents.
Wanneer u deze methode gebruikt, gaat alles verloren tijdens de migratie wat afkomstig is van agents, hardwarestatistieken, TS-logboeken, belastingen voor visualisaties en hyperquery's in de wachtrij en wat nog niet is verwerkt. 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 die de instructies zelfstandig kunnen implementeren en zich niet willen bezighouden met het opnieuw creëren van omgevingen en het opnieuw creëren van drempelwaarden voor incidenten. Met deze methode voorkomt u dat gebeurtenisdata verloren gaan tijdens de overgang. De informatie over het aantal processen die tijdens de overgang van Tableau Server-hardware voor knooppunten is vastgelegd, blijft echter niet behouden. Deze migratie is handmatig en geen ingebouwde migratiefunctie voor Resource Monitoring Tool.
Hieronder vindt u de instructies om dit te doen:
Migreren naar externe AWS AMQ
Stap 1: Amazon AMQ maken voor Rabbit MQ om de externe berichtenwachtrijservice te hosten met de volgende aanbevelingen:
- Gebruik het enginetype RabbitMQ.
- Standaardversie (3.9.13) is gelijk aan de gebundelde versie van RMT 22.2.
- Gebruik een single-instance broker.
- Gebruik de standaardgrootte voor het exemplaar (mq.m5.large, 2 vCPU/8 GiB RAM).
- Stel een RabbitMQ-gebruikersnaam/-wachtwoord in.
Zie Werken met Amazon MQ voor Rabbit MQ op de AWS-documentatiesite voor meer informatie.
Stap 2: de verbinding vanaf de RMT-server testen
Kopieer de URL van de RabbitMQ-webconsole van de AWS MQ-pagina en plak deze in een webbrowser op RMT Server. Log in met de gebruikersnaam en het wachtwoord dat/die u hebt aangemaakt bij het instellen van de broker.
Stap 3: RMT Agent-services stoppen en registratie van agents verwijderen
Voer de volgende opdrachten uit op elk knooppunt waar een agent wordt uitgevoerd: Stop RMT Server niet, deze moet ingeschakeld blijven:
rmtadmin stop
rmtadmin deregister
Stap 4: de wachtrij controleren.
Voer op de RMT-server het volgende uit: rmtadmin status
. Bekijk de uitvoer. Wanneer alle waarden in de kolom Totaal voor elke wachtrij 0 (of bijna 0) bereiken en op die waarde blijven, gaat u door naar de volgende stap.
Stap 5: Tableau Server configureren voor gebruik van de nieuwe Amazon MQ-service
De waarde van aws_amq_servername is dezelfde als die van het eindpunt dat op de pagina van Amazon MQ wordt vermeld. Behalve dat het voorvoegsel van het protocol en de poort aan het einde moeten worden verwijderd. Zie het volgende voorbeeld:
Vervang: 'amqps://b-9512e888-a4a3-4b79-a9c0-07418c101941.mq.us-west-2.amazonaws.com:5671
" met: "B-9512e888-a4a3-4b79-a9c0-07418c101941.mq.us-west-2.amazonaws.com
’
Voer nu rmtadmin master-setup
uit, waarbij u de gebruikersnaam en het wachtwoord vervangt die u voor Amazon MQ hebt gemaakt.
rmtadmin master-setup --mq-config=external --mq-server=aws_amq_servername --mq-vhost='/' --mq-port=5671 --mq-username=aws_amq_username --mq-password=<aws_amq_password> --mq-tls-certificate-host=<aws_amq_servername>
Let op het volgende:
- Vervang de naam in het argument --mq-vhost hieronder alleen als u uw eigen virtuele host hebt gemaakt (dit is optioneel).
- Wijzig op vergelijkbare wijze de poort als de service is ingesteld voor uitvoering op een andere poort dan de standaardpoort.
- De waarde voor --mq-tls-certificate-host moet de servernaam voor uw AWS MQ-exemplaar zijn, zoals eerder gebruikt in het argument --mq-server. Het kan echter ook een jokerteken zijn voor extra flexibiliteit.
Stap 6: de identiteitsmigratie starten
Ga naar de installatiemap van RMT Server: cd 'c:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\'
Ga naar de installatiemap van RMT Server: sudo /var/opt/tableau/tabrmt/master
Start RMT Server: rmtadmin start
Stap 7: agents opnieuw registreren
- Download een nieuw bootstrap-bestand van RMT Server.
- Ga naar http://localhost:9002/setup/register voor toegang tot de webinterface van de agent en importeer het bootstrap-bestand.
- 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’
Stap 8: controleren of de RMT-server actief is
Log in bij de webinterfacetool van RMT Server en controleer of er nieuwe data worden verwerkt.
Best practices bijwerken
Hieronder staan de algemene stappen die u moet volgen als u wilt upgraden naar versie 2022.3 of hoger en tegelijkertijd wilt migreren naar een externe berichtenwachtrijservice.
Migratie met opnieuw aanmaken in de omgeving:
- Upgrade RMT Server en alle agents naar 2022.3 of later
- Maak een Amazon AMQ-brokerservice aan.
- Configureer RMT Server om de externe berichtenwachtrijservice te gebruiken
- Maak omgevingen opnieuw aan en registreer alle agents opnieuw
- Maak eventuele aangepaste configuraties opnieuw.
Opmerking: u verliest informatie over gebeurtenis- en hardwareverwerking en u moet de drempelwaarden voor incidenten ook 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 van dit onderwerp. Dit houdt voornamelijk in dat er een Amazon AMQ-brokerservice wordt aangemaakt en dat de RMT-server naar de externe berichtenwachtrijservice wordt verwezen.
- Registreer de agenten opnieuw.
Upgradestappen bij inschakelen van TLS voor RabbitMQ
Omdat de agents in versies ouder dan 2022.3 via een niet-versleutelde verbinding met de service voor de RabbitMQ-berichtenwachtrij communiceerden, moeten deze agents bij een upgrade naar versie 2022.3 of hoger worden bijgewerkt om de nieuwe beveiligde verbindingsdata te gebruiken. De stappen hiervoor zijn als volgt:
Nadat u de upgradestappen hebt voltooid die in de bovenstaande sectie zijn beschreven, stopt u alle agents door de volgende opdracht uit te voeren:
rmtadmin stop --agent
Download het bootstrap-bestand voor de omgeving door de volgende opdracht uit te voeren:
rmtadmin bootstrap-file --env<myenvironment> --filename <The absolute or relative path including the file name>
Voer de volgende opdracht uit op elke computer waarop de agent is geïnstalleerd:
rmtadmin rotate-mq-certificate <BOOTSTRAP_FILE> --username=<RMT Server Username> --password-file=<RMT Server Password file name>
- Start elke computer met de agent opnieuw op door uitvoeren van de opdracht
rmtadmin rotate-mq-certificate
.
Productcompatibiliteit
In deze tabel worden alleen RMT-versie 2022.3 en later weergegeven, aangezien de externe berichtenwachtrij pas vanaf versie 2022.3 beschikbaar is.
RMT-versie | RabbitMQ-versie meegeleverd met RMT | Ondersteuning van RabbitMQ-versie voor externe berichtenwachtrijservice |
22.3 | 3.10.5 | 3.10.5 |
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.