Installation von „ IDOT “ auf „ Windows “ mithilfe des MSI-Installationsprogramms

Online bearbeiten

Der „ Instana “-Distribution des „ OpenTelemetry “-Collectors ( IDOT ) kann mithilfe eines Microsoft Installer (MSI)-Pakets auf Systemen mit „ Windows “ installiert werden. Diese Installationsmethode bietet eine grafische Benutzeroberfläche (GUI) für eine einfache Konfiguration und die automatische Einrichtung von Diensten.

Voraussetzungen

Bevor Sie „ IDOT “ auf Windows installieren, stellen Sie bitte sicher, dass Sie über Folgendes verfügen:

  • Windows Windows, 11 oder Windows Server 2016 oder höher (64-Bit).
  • Administratorrechte.
  • Netzwerkverbindung zum Herunterladen des MSI-Installationsprogramms.
  • Dein Instana -Agentenschlüssel.
  • Informationen zu Ihrem Backend-Endpunkt für „ Instana “.

Das MSI-Installationsprogramm herunterladen

Laden Sie das neueste MSI-Installationsprogramm für „ IDOT “ für „ Windows “ von der offiziellen Release-Seite unter GitHub herunter. Suchen Sie unter der neuesten Version nach der Datei mit instana-otel-collector-installer-latest-windows-amd64-msi.zip dem Namen.

IDOT über die grafische Benutzeroberfläche installieren

  1. Doppelklicken Sie auf die heruntergeladene MSI-Datei, um den Installationsassistenten zu starten.
  2. Klicken Sie auf dem Begrüßungsbildschirm auf „Weiter “.
  3. Lesen Sie die Lizenzvereinbarung durch und stimmen Sie ihr zu. Klicken Sie anschließend auf „Weiter “.
  4. Übernehmen Sie das Standardinstallationsverzeichnis (C:\Program Files\Instana\instana-collector\) oder geben Sie einen benutzerdefinierten Speicherort an und klicken Sie dann auf „Weiter “.
  5. Konfigurieren Sie die erforderlichen Parameter:
    • Instana Agentenschlüssel : Geben Sie Ihren Instana -Agentenschlüssel zur Authentifizierung ein.
    • OTLP gRPC Endpunkt : Geben Sie den Endpunkt „ gRPC “ ein (Format: <endpoint>:<port>).
    • OTLP HTTP Endpunkt : Geben Sie den Endpunkt „ HTTP “ ein (Format: <endpoint>:<port>).
  6. Klicken Sie auf Install, um die Installation zu starten.
  7. Klicken Sie auf „Fertig stellen“, sobald die Installation abgeschlossen ist.

Das Installationsprogramm führt automatisch folgende Schritte aus:

  • Erstellt die Verzeichnisstruktur für die Installation
  • Konfiguriert den Collector-Dienst
  • Startet den „ Instana “-Collector-Dienst
  • Registriert den Dienst so, dass er beim Systemstart automatisch gestartet wird

MSI-Installationsparameter

Die folgenden Parameter können mit dem MSI-Installationsprogramm verwendet werden:

Parameter Erforderlich Beschreibung Beispiel
INSTANA_KEY Ja Instana Agentenschlüssel zur Authentifizierung "<your_agent_key>"
INSTANA_OTEL_ENDPOINT_GRPC Ja gRPC Endpunkt für „ OTLP “-Daten "otlp-grpc-<region>-saas.instana.io:443"
INSTANA_OTEL_ENDPOINT_HTTP Ja HTTP Endpunkt für „ OTLP “-Daten "otlp-http-<region>-saas.instana.io:443"
INSTALLDIR Nein Installationsverzeichnis "C:\Program Files\Instana\instana-collector"

So ermitteln Sie Ihre Konfigurationswerte:

Diese Parameter finden Sie in der Benutzeroberfläche von „ Instana “ unter „Agent & Collectors“ > „ OpenTelemetry -Collectors “:
  • Klicken Sie auf „Collector installieren“ > „ Windows “.
  • Im Installationsbefehl:
    • INSTANA_KEY: Suchen Sie nach dem Agentenschlüssel hinter dem -a Flag.
    • INSTANA_OTEL_ENDPOINT_GRPC: Suchen Sie nach dem Endpunkt „ gRPC “ hinter dem -e Flag.
    • INSTANA_OTEL_ENDPOINT_HTTP: Suchen Sie nach dem Endpunkt „ HTTP “ hinter dem -H Flag.

Weitere Informationen zu den vollständigen Systemanforderungen finden Sie unter „ IDOT -Systemanforderungen “.

Konfiguration für die Verbindung mit einem lokalen „ Instana “-Agenten

Wenn Sie Daten über einen lokalen „ Instana “-Agenten auf demselben „ Windows “-Host senden, verwenden Sie 127.0.0.1 für die Endpunkte:

msiexec /i instana-otel-collector-windows-amd64.msi /quiet `
  INSTANA_OTEL_ENDPOINT_GRPC="http://127.0.0.1:4317" `
  INSTANA_OTEL_ENDPOINT_HTTP="http://127.0.0.1:4318"

Überprüfen und aktualisieren Sie nach der Installation die Konfigurationsdatei unter C:\Program Files\Instana\instana-collector\config\config.env , um das Protokoll „ HTTP “ zu verwenden:

INSTANA_OTEL_ENDPOINT_GRPC=http://127.0.0.1:4317
INSTANA_OTEL_ENDPOINT_HTTP=http://127.0.0.1:4318
Wichtig: Wenn Sie auf „localhost“ ( 127.0.0.1 ) verweisen, verwenden Sie http:// anstelle von https://. Der lokale Agent verwendet bei Verbindungen zum lokalen Host keine „ TLS “-Verschlüsselung.

Konfiguration für die Verbindung zum Backend „ Instana “

Wenn Sie Daten direkt an das Backend von „ Instana “ senden, verwenden Sie die folgenden Endpunkte:

msiexec /i instana-otel-collector-windows-amd64.msi /quiet `
  INSTANA_KEY="<your_instana_key>" `
  INSTANA_OTEL_ENDPOINT_GRPC="<your_instana_otel_grpc_endpoint>" `
  INSTANA_OTEL_ENDPOINT_HTTP="<your_instana_otel_http_endpoint>"

Konfiguration nach der Installation

Nach der Installation können Sie die Konfiguration ändern, indem Sie die folgenden Dateien bearbeiten:

Umgebungs- konfiguration

Bearbeiten C:\Program Files\Instana\instana-collector\config\config.env , um die Umgebungsvariablen zu aktualisieren:

INSTANA_KEY=<your_agent_key>
INSTANA_OTEL_ENDPOINT_GRPC=<your_instana_otel_grpc_endpoint>:443
INSTANA_OTEL_ENDPOINT_HTTP=<your_instana_otel_http_endpoint>:443

Collectorkonfiguration

Bearbeiten C:\Program Files\Instana\instana-collector\config\config.yaml Sie die Einstellungen, um das Verhalten des Collectors sowie Empfänger, Prozessoren und Exporter anzupassen. Weitere Informationen finden Sie unter „Konfigurieren des Collectors für den Dienst „ OpenTelemetry “.

Nachdem Sie die Konfigurationsänderungen vorgenommen haben, starten Sie den Dienst neu:

Restart-Service "InstanaOTelCollector"

Verwaltung des Dienstes „ Windows “

Das MSI-Installationsprogramm erstellt „ Windows “-Dienste, die mit den Standard-Tools von „ Windows “ verwaltet werden können.

Unter Verwendung von PowerShell

Starten Sie den Service:

Start-Service "InstanaOTelCollector"

Stoppen Sie den Service wie folgt:

Stop-Service "InstanaOTelCollector"

Starten Sie den Dienst neu:

Restart-Service "InstanaOTelCollector"

Servicestatus prüfen:

Get-Service "InstanaOTelCollector"

Über die Services-Konsole

  1. services.mscDrücke Win+R und gib ein.
  2. Suchen Sie in der Liste nach „ "InstanaOTelCollector" “.
  3. Klicken Sie mit der rechten Maustaste und wählen Sie „Starten“, „Beenden“ oder „Neustart “.

Über die Eingabeaufforderung (cmd)

Starten Sie den Service:

sc start "InstanaOTelCollector"

Stoppen Sie den Service wie folgt:

sc stop "InstanaOTelCollector"

Dienststatus abfragen:

sc query "InstanaOTelCollector"

Installation überprüfen

Überprüfen Sie nach der Installation, ob der Collector läuft und Daten sendet:

  1. Überprüfen Sie den Servicestatus wie folgt:
    Get-Service "InstanaOTelCollector"
  2. Überprüfen Sie den Ereignis-Viewer unter Windows :
    Get-EventLog -LogName Application -Source "InstanaOTelCollector" -Newest 20

    Oder öffnen Sie die Benutzeroberfläche der Ereignisanzeige:

    • Drücke Win+R, gib eventvwr.mscein und drücke die Eingabetaste.
    • Navigieren Sie zu „ Windows -Protokolle > Anwendung “.
    • Filtern Sie nach der Quelle „ "InstanaOTelCollector" “, um dienstbezogene Ereignisse anzuzeigen.
  3. Überprüfen Sie die Verbindung zum Backend unter Instana :
    Test-NetConnection -ComputerName <your_endpoint> -Port 443

IDOT deinstallieren

Über die MSI-Benutzeroberfläche

  1. Öffnen Sie die Systemsteuerung > Programme und Funktionen.
  2. Suchen Sie in der Liste nach „ InstanaOpenTelemetry -Collector“.
  3. Klicken Sie mit der rechten Maustaste darauf und wählen Sie „Deinstallieren “.
  4. Folgen Sie den Anweisungen des Deinstallationsassistenten.

IDOT aktualisieren

So führen Sie ein Upgrade auf eine neuere Version durch:

  1. Laden Sie das neueste MSI-Installationsprogramm herunter.
  2. Führen Sie das neue MSI-Installationsprogramm aus (es erkennt die vorhandene Installation automatisch und aktualisiert sie).
  3. Das Installationsprogramm behält Ihre Konfigurationsdateien während des Upgrades bei.

Fehlerbehebung

Installation schlägt fehl

  • Stellen Sie sicher, dass Sie über Administratorrechte verfügen.
  • Vergewissern Sie sich, dass kein anderer Prozess das Installationsverzeichnis nutzt.

Der Dienst wird nicht gestartet

  • Überprüfen Sie, ob config.env die Konfiguration korrekt ist.
  • Überprüfen Sie den Ereignisprotokoll-Viewer unter „ Windows “ auf Fehlermeldungen.
  • Stellen Sie die Netzwerkverbindung zum Backend von „ Instana “ sicher.
  • Überprüfen Sie die Collector-Protokolle im C:\Program Files\Instana\instana-collector\logs Verzeichnis.

Verbindungsprobleme

  • Stellen Sie sicher, dass die Firewall-Regeln ausgehende Verbindungen über Port 443 zulassen.
  • Verbindung testen: Test-NetConnection -ComputerName <your_endpoint> -Port 443.
  • Stellen Sie bei Verbindungen zum lokalen Host sicher, dass HTTP (und nicht HTTPS ) verwendet wird.

Weitere Anleitungen zur Fehlerbehebung finden Sie unter „Fehlerbehebung bei der „ IDOT “.

Weitere Informationen