Skip to main content

Server-Nutzungsbericht

Verwenden Sie den Server-Nutzungsbericht, um Metriken für Benutzer:innen, Apps, Berechtigungen, Zeitpläne und Aufträge zu verstehen, damit Sie Probleme mit Leistung, Prüfung und Compliance schnell beurteilen können. Stellen Sie eine Verbindung zu Ihrer MongoDB und Server-API her, um relevante Daten und Analysen ganz einfach aus Ihrem Alteryx Server zu extrahieren. Wählen Sie Ihre bevorzugte Ausgabe, einschließlich: Tableau Dashboard, separate Dateien, Datenbank, oder verwenden Sie die Makroausgaben für nachgeschaltete Prozesse.

Sie können den Server-Nutzungsbericht über den Alteryx Marketplace herunterladen.

Anforderungen

Der Server-Nutzungsbericht ist mit Designer Version 2023.2 und höher kompatibel. Verwenden Sie den neuesten verfügbaren Patch für Ihre Designer-Version.

Dienstprogramm für Server-Nutzungsbericht und die Abhängigkeiten installieren

Folgen Sie diesen Schritten, um den Server-Nutzungsbericht und die damit verbundenen Abhängigkeiten zu installieren.

YXI installieren

  1. Laden Sie die Datei Server_Usage_Report.yxi vom Alteryx Marketplace herunter.

  2. Doppelklicken Sie auf die YXI-Datei, um das Dienstprogramm mit Designer zu installieren.

  3. Folgen Sie den Eingabeaufforderungen:

    • Für mein Konto installieren: Nur Ihr Benutzerkonto hat Zugriff auf das Dienstprogramm auf dem Rechner. Installiert unter: %AppData%\Alteryx\.

    • Für alle Benutzer:innen installieren: Alle Benutzer:innen haben Zugriff auf das Dienstprogramm auf dem Rechner. Installiert unter: %ProgramData%\Alteryx\.

  4. Nach Abschluss des Vorgangs öffnen Sie den Workflow „Erste Schritte“. Gehen Sie in Designer zu Hilfe > Beispiel-Workflows > Enterprise Utilities > Server-Nutzungsbericht > Erste Schritte.

Tableau-Ausgabekonnektor installieren

Anmerkung

Dies ist ein optionales Element. Der Tableau-Ausgabekonnektor ist nur erforderlich, wenn Sie die Ausgabe in Tableau schreiben möchten. Der Workflow kann ohne Tableau-Ausgabe funktionieren, solange Sie die Option zum Schreiben in Tableau nicht auswählen.

  1. Laden Sie den Tableau-Ausgabekonnektor von Alteryx Marketplace herunter.

  2. Doppelklicken Sie auf die YXI-Datei, um den Konnektor über Designer zu installieren.

  3. Folgen Sie den Eingabeaufforderungen:

    • Für mein Konto installieren: Nur Ihr Benutzerkonto hat Zugriff auf das Tool auf dem Rechner. Installiert unter: %AppData%\Alteryx\.

    • Für alle Benutzer:innen installieren: Alle Benutzer:innen haben Zugriff auf das Tool auf dem Rechner. Installiert unter: %ProgramData%\Alteryx\.

Simba-Treiber für MongoDB installieren

  1. Laden Sie den Simba-Treiber aus dem Alteryx Lizenzierungsportal herunter.

  2. Scrollen Sie zum Ende des Abschnitts „Produkt-Downloads“ und wählen Sie Herunterladen rechts neben dem Eintrag Treiber aus.

  3. Wählen Sie „MongoDB“ in der Versionsliste aus und wählen Sie Weiter.

  4. Wählen Sie Herunterladen rechts neben dem Eintrag Simba MongoDB 2.3.22.1024 64-bit aus.

  5. Doppelklicken Sie auf die MSI-Datei, um den Treiber auf Ihrem Rechner zu installieren. Der Treiber ist nun im ODBC-Administrator-Hilfsprogramm verfügbar.

DSN für MongoDB-Verbindungen einrichten

Richten Sie als Nächstes die DSN-Einstellungen für MongoDB-Verbindungen ein. Führen Sie die folgenden Schritte aus.

  1. Öffnen Sie den ODBC-Datenquellen-Administrator (64 Bit) auf Ihrem Rechner.

  2. Erstellen Sie eine neue Datenquelle mithilfe von Simba MongoDB ODBC-Treiber (Version 2.03.22.1024).

  3. Füllen Sie die folgenden Felder aus:

    • Name der Datenquelle: Dieser Name kann beliebig sein, muss jedoch eingegeben werden, selbst wenn vorübergehend die ODBC-Verbindung verwendet wird.

    • Server: Ihr Servername.

    • Port: Ihr Serverport (27018 für eingebettete MongoDB).

    • Datenbank: AlteryxService (oder AlteryxGallery, je nachdem, welche Datenbank Sie aktualisieren).

    • Mechanismus: SCRAM-SHA-256

    • Authentifizierungsquelle: Gleichen Sie den Datenbanknamen aus der Eingabe „d“ oben ab.

    • Benutzername: DB-Benutzername, normalerweise „Benutzer“.

    • Kennwort: DB-Kennwort. Überprüfen Sie die Alteryx-Systemeinstellungen auf das eingebettete MongoDB-Kennwort.

  4. Wählen Sie Test... aus, um sicherzustellen, dass die Verbindung erfolgreich hergestellt wurde.

  5. Wählen Sie Erweiterte Optionen... aus.

  6. Aktualisieren Sie die Werte für die Größe der binären Spalte auf 2147483647.

  7. Wählen Sie im Abschnitt Metadaten unter „Mechanismus“ die Option Lokale Datei aus.

  8. Wählen Sie Durchsuchen... und wählen Sie die entsprechende Schemadatei aus, die sich im versionsspezifischen MongoDB-Schemaordner befindet:

    • Für Versionen bis 2023.2:

      • Schemadatei: MongoDB_Schema_23.2.json

      • Benutzer-Installationsverzeichnis: %appdata%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_23.2.json

      • Admin-Installationsverzeichnis: %ProgramData%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_23.2.json

    • Für Versionen 2024.1 und höher:

      • Schemadatei: MongoDB_Schema_24.1Plus.json

      • Benutzer-Installationsverzeichnis: %appdata%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_24.1Plus.json

      • Admin-Installationsverzeichnis: %ProgramData%\Alteryx\Samples\data\Enterprise Utilities\Server Usage Report\supporting_macros\SimbaMongoDB_SchemaFiles\MongoDB_Schema_24.1Plus.json

  9. Wählen Sie Öffnen, OK und wieder OK aus.

  10. Wiederholen Sie die obigen Schritte für die AlteryxService-Datenbank.

DCM-Verbindungen für MongoDB erstellen

Der nächste Schritt besteht darin, Verbindungen für MongoDB im Data Connection Manager (DCM) zu erstellen.

  1. Öffnen Sie DCM. Navigieren Sie in Designer zu Datei > Verbindungen verwalten.

  2. Wählen Sie auf der Registerkarte Datenquellen die Option + Neu und dann die Kachel MongoDB aus.

  3. Wählen Sie im Auswahlmenü Technologie die Option MongoDB ODBC aus.

    • Name der Datenquelle: Geben Sie den Namen der Mongo AlteryxService-Datenquelle aus dem Abschnitt DSN für MongoDB-Verbindungen einrichten oben ein.

    • ODBC DSN: Wählen Sie den zuvor erstellten MongoDB AlteryxService ODBC DSN aus.

  4. Wählen Sie Speichern und dann Anmeldedaten verknüpfen aus.

  5. Füllen Sie die folgenden Felder aus:

    • Authentifizierungsmethode: MongoDB-Benutzername und -Kennwort

    • Anmeldedaten: Neue Anmeldedaten erstellen

    • Anmeldename: beliebiger Name (zum Beispiel MongoDB_AlteryxService_Local).

    • Tresor: DCM

    • Benutzername: Benutzer

    • Kennwort: Ihr Kennwort.

    • Authentifizierungsmethode: SCRAM-SHA-256

    • Authentifizierungsquelle: AlteryxService

    • Verbindung für SDK zulassen: Deaktiviert

  6. Wählen Sie Verbindung testen aus. Bei Erfolg wählen Sie Erstellen und verknüpfen aus.

  7. Wiederholen Sie diese Schritte für die AlteryxGallery-Datenbank.

DCM-Verbindung zu Server-API erstellen

  1. Öffnen Sie DCM. Navigieren Sie in Designer zu Datei > Verbindungen verwalten.

  2. Wählen Sie auf der Registerkarte Datenquellen die Option + Neu und dann die Kachel Herunterladen aus.

    • Name der Datenquelle: Name Ihrer Wahl (z. B. Server-API).

    • Basis-URL: Geben Sie die Basis-URL für Ihre Server-API ein. Diese endet mit /webapi/.

      Beispiel: https://CompanyServerName/webapi/

  3. Wählen Sie Speichern aus.

  4. Wählen Sie Anmeldedaten verbinden aus.

  5. Wählen Sie aus dem Auswahlmenü Authentifizierungsmethode die Option Benutzername und Kennwort aus.

  6. Wählen Sie im Auswahlmenü Anmeldedaten die Option Neue Anmeldedaten erstellen aus.

    • Anmeldename: Name Ihrer Wahl (z. B. Server-API-Schlüssel).

    • Tresor: Wählen Sie DCM aus.

    • Benutzername: Geben Sie Ihren API-Zugriffsschlüssel in Ihrem Gallery-Profil ein.

    • Kennwort: Geben Sie Ihr API-Zugriffsgeheimnis ein, das Sie in Ihrem Gallery-Profil finden.

  7. Wählen Sie Erstellen und Verknüpfen aus.

(Optional) Cache- und Ausgabedatenbanken für DCM-Verbindungen

  1. Öffnen Sie DCM. Navigieren Sie in Designer zu Datei > Verbindungen verwalten.

  2. Wählen Sie + Neu und dann die Kachel MongoDB aus.

  3. Wählen Sie im Auswahlmenü Technologie die gewünschte Datenbank aus und beenden Sie die Einrichtung der Verbindung.

(Optional) Erforderliche Tabellen in Ausgabedatenbanken erstellen

Führen Sie die folgenden Apps aus, um die erforderlichen Tabellen in den Ausgabedatenbanken zu erstellen. Dieser Schritt ist je nach Präferenz optional. Sie ist auch optional, wenn die Cache-Datenbank nicht verwendet wird oder wenn die Daten nicht in Datenbanktabellen ausgegeben werden. Wenn eines der beiden verwendet wird, führen Sie die entsprechende App aus.

  • Wenn Sie eine Datenbank verwenden, um die heruntergeladenen Workflow-Pakete aus der Gallery im Cache zu speichern, führen Sie „Cache-Datenbanktabellen erstellen (App)“ aus.

  • Wenn Sie eine Datenbank zur Ausgabe der endgültigen Daten in Tabellen verwenden, führen Sie „Ausgabedatentabellen erstellen (App)“ aus.

Alteryx Server-Nutzungsbericht ausführen

Führen Sie die folgenden Schritte aus, um den Server-Nutzungsbericht auszuführen:

  1. Geben Sie die Anmeldedaten ein, die in den vorherigen Schritten erstellt wurden:

    • Alteryx Gallery: DCM-Verbindung zur AlteryxGallery-Datenbank.

    • Alteryx Dienst: DCM-Verbindung zur AlteryxService-Datenbank.

    • API-Anmeldedaten: DCM-Verbindung zu den Server-API-Anmeldedaten.

    • Aufträge und Ergebnisse nach Datum filtern: Beschränkt die Abfragen der Tabellen „AS_Queue“ (Aufträge) und „AS_Results“ (Ergebnismeldungen) so, dass nur Daten bis zu einem bestimmten Datum abgerufen werden.

    • Im Cache gespeicherte Workflow-Datenbank verwenden (optional): Speichern Sie die App-Paketdownloads aus den API-Aufrufen im Cache. Verwenden Sie diese Option, wenn Ihr Designer über viele Workflows verfügt, da das Herunterladen jeder Ausführung lange dauern kann.

    • Ausgabe in Tableau-Hyper-Datei: Legen Sie fest, wo die Tableau-Hyper-Datei ausgegeben werden soll. Lassen Sie dies als Standard-Ausführung stehen, wenn dies Ihre erste Ausführung ist, um die Tableau-Arbeitsmappe zu testen.

    • Ausgabe in Datenbanktabellen (optional): Verwenden Sie die DCM-Verbindung, um die Daten in separaten Tabellen in Ihrer eigenen Datenbank auszugeben.

    • Ausgabe in separate Dateien (optional):

      • (Optional) Wählen Sie einen Speicherort (Ordner) aus, um die separaten Dateien zu speichern. Leer = .\Output-Ordner.

      • (Optional) Geben Sie den Präfix ein. Leer = kein Präfix.

      • Wählen Sie den Dateityp aus (CSV oder YXDB).

  2. Führen Sie den Workflow aus.

  3. Navigieren Sie zum angegebenen Ordner, um die Tableau-Arbeitsmappe zu öffnen und die Daten anzuzeigen. Wenn die Hyper-Datei an einen anderen Ort ausgegeben wurde, verbinden Sie die Datenquelle innerhalb von Tableau erneut, um Ihre Daten anzuzeigen.

Fehlerbehandlung

In diesem Abschnitt finden Sie häufige Probleme und Schritte zur Fehlerbehebung.

Berechtigungen überprüfen

Stellen Sie zunächst sicher, dass die richtigen Berechtigungen in der Alteryx Server-Benutzeroberfläche zum Herunterladen von Workflows festgelegt sind:

  • Gehen Sie in Server zu Admin-Bereich > Einstellungen > Assets: Stellen Sie sicher, dass Direktes Herunterladen deaktivieren nicht ausgewählt ist.

  • Benutzer:innen müssen das Kontrollkästchen Andere können diesen Workflow herunterladen in den Einstellungen jedes Workflows auswählen. Diese Option ist standardmäßig aktiviert. Wenn Sie dieses Kontrollkästchen nicht explizit deaktivieren, sollte das Workflow-Paket die richtigen Berechtigungen haben.

  • Der/Die Benutzer:in, der/die den Server-Nutzungsbericht ausführt, muss den API-Zugriff aktiviert haben, um API-Token abzurufen.

Zusätzliche Hinweise zur Fehlerbehebung

Unten finden Sie eine Übersicht über häufige Fehler und vorgeschlagene Lösungsschritte.

Antwort „500 Not Found“

Lesen Sie diesen Community-Artikel.

Alteryx Server-Nutzungsbericht (8): PullServiceDetails (1483): Tool #147: Interner Fehler: Versuch, über das Ende eines Blobs hinaus zu lesen.

Prüfen Sie die erweiterten ODBC-DSN-Einstellungen. Die Binärspaltengröße muss 2147483647 sein.

Alteryx Server-Nutzungsbericht (8): Workflowdetails konnten nicht aus Alteryx Server abgerufen werden: HTTP/1.1 500 Interner Serverfehler

Prüfen Sie, ob der Workflow beschädigt ist. Bestätigen Sie, dass er auf Server ausgeführt werden kann.

Alteryx Server-Nutzungsbericht (8): Workflowdetails konnten nicht aus Alteryx Server abgerufen werden: HTTP/1.1 403 Forbidden

Prüfen Sie, ob der Workflow heruntergeladen werden kann und ob die globalen Einstellungen das Herunterladen von Workflows zulassen. Überprüfen Sie dann die Einstellung „Direktes Herunterladen deaktivieren“ in den Administrator > Einstellungen von Server.

HTTP/1.1 404 oder HTTP/1.1 401 oder „RetrieveServerOAuthToken: Der Test „DownloadSucceeded“ ist fehlgeschlagen

Prüfen Sie, ob die baseURL der DCM-Verbindung „http://localhost/webapi/” ist (beachten Sie das Suffix /webapi und das nachfolgende „/“, verwenden Sie /Gallery/ nicht hier).

Bestätigen Sie, dass der Zugriffsschlüssel (Benutzername) und das Zugriffsgeheimnis (Kennwort) der DCM-Verbindung korrekt sind.

Überprüfen Sie, ob AlteryxService ausgeführt wird und Sie auf Gallery oder die Swagger-Dokumentation (API) zugreifen können. Wenn nicht, starten Sie den AlteryxService unter „Dienste“ neu.

In diesem Abschnitt: