Web-Apps überwachen und schützen

Nachdem Sie Ihre Apps veröffentlicht haben, sollten Sie sie überwachen und schützen:

Websiteleistung mit App Hosting Observability überwachen

Im Bereich App-Übersicht in Firebase Studio finden Sie wichtige Messwerte und Informationen zu Ihrer App. So können Sie die Leistung Ihrer Web-App mit den integrierten Observability-Tools von App Hosting's überwachen. Nachdem Ihre Website eingeführt wurde, können Sie auf die Übersicht zugreifen, indem Sie auf Veröffentlichen klicken. In diesem Bereich haben Sie folgende Möglichkeiten:

  • Klicken Sie auf Veröffentlichen , um eine neue Version Ihrer App freizugeben.
  • Teilen Sie den Link zu Ihrer App oder öffnen Sie sie direkt unter App aufrufen.
  • Sehen Sie sich eine Zusammenfassung der Leistung Ihrer App in den letzten sieben Tagen an, einschließlich der Gesamtzahl der Anfragen und des Status der letzten Einführung. Klicken Sie auf Details ansehen , um noch mehr Informationen in der Firebase Console aufzurufen.
  • Sehen Sie sich ein Diagramm mit der Anzahl der Anfragen an, die Ihre App in den letzten 24 Stunden erhalten hat, aufgeschlüsselt nach HTTP-Statuscode.
  • Sehen Sie sich den Aktivierungsstatus von Firebase-Diensten wie Firebase Authentication und Cloud Firestore an.

Wenn Sie den Bereich „App-Übersicht“ schließen, können Sie ihn jederzeit wieder öffnen, indem Sie auf Veröffentlichen klicken.

Weitere Informationen zum Verwalten und Überwachen von App Hosting Rollouts finden Sie unter Rollouts und Releases verwalten.

Genkit Monitoring für Ihre bereitgestellten Funktionen

Sie können die Schritte, Eingaben und Ausgaben Ihrer Genkit Funktionen überwachen, indem Sie die Telemetrie für Ihren KI-Ablaufcode aktivieren. Mit der Telemetriefunktion von Genkit können Sie die Leistung und Nutzung Ihrer KI-Abläufe überwachen. Anhand dieser Daten können Sie Bereiche mit Verbesserungspotenzial identifizieren, Probleme beheben, Ihre Prompts und Abläufe für eine bessere Leistung und Kosteneffizienz optimieren und die Nutzung Ihrer Abläufe im Zeitverlauf verfolgen.

Wenn Sie das Monitoring in Genkit einrichten möchten, fügen Sie den Genkit KI-Abläufen Telemetrie hinzu und sehen sich dann die Ergebnisse in der Firebase Console an.

Schritt 1: Telemetrie zu Ihrem Genkit Flow-Code in Firebase Studio hinzufügen

So richten Sie das Monitoring in Ihrem Code ein:

  1. Wenn Sie sich noch nicht in der Code Ansicht befinden, klicken Sie auf Symbol für Sprachwechsel Zu Code wechseln , um sie zu öffnen.

  2. Prüfen Sie in package.json, welche Version von Genkit installiert ist.

  3. Öffnen Sie das Terminal (Ctrl-Shift-C oder Cmd-Shift-C unter macOS).

  4. Klicken Sie in das Terminal und installieren Sie das Firebase-Plug-in mit der Version, die Ihrer package.json-Datei entspricht. Wenn die Genkit Pakete in Ihrer package.json beispielsweise die Version 1.0.4 haben, führen Sie den folgenden Befehl aus, um das Plug-in zu installieren:

    npm i --save @genkit-ai/firebase@1.0.4

  5. Maximieren Sie im Explorer src > ai > flows. Im Ordner flows werden eine oder mehrere TypeScript-Dateien mit Ihren Genkit Abläufen angezeigt.

  6. Klicken Sie auf einen der Abläufe, um ihn zu öffnen.

  7. Fügen Sie unten im Abschnitt „Imports“ der Datei Folgendes hinzu, um FirebaseTelemetry zu importieren und zu aktivieren:

    import { enableFirebaseTelemetry } from '@genkit-ai/firebase';

enableFirebaseTelemetry();

Schritt 2: Berechtigungen einrichten

Firebase Studio hat die erforderlichen APIs für Sie aktiviert, als Ihr Firebase-Projekt eingerichtet wurde. Sie müssen aber auch Berechtigungen für das App Hosting Dienstkonto gewähren.

So richten Sie Berechtigungen ein:

  1. Öffnen Sie die Google Cloud IAM Console wählen Sie Ihr Projekt aus und gewähren Sie dem App Hosting Dienstkonto die folgenden Rollen:

    • Monitoring-Messwert-Autor (roles/monitoring.metricWriter)
    • Cloud Trace-Agent (roles/cloudtrace.agent)
    • Log-Autor (roles/logging.logWriter)

  2. Veröffentlichen Sie Ihre App noch einmal in App Hosting.

  3. Wenn die Veröffentlichung abgeschlossen ist, laden Sie Ihre App und verwenden Sie sie. Nach fünf Minuten sollten in Ihrer App Telemetriedaten protokolliert werden.

Schritt 3: Funktionen basierend auf generativer KI in der Firebase Console überwachen

Wenn die Telemetrie konfiguriert ist, Genkit erfasst die Anzahl der Anfragen, Erfolg und Latenz für alle Ihre Abläufe. Für jeden einzelnen Ablauf Genkit erfasst Stabilitätsmesswerte, zeigt detaillierte Diagramme an und protokolliert erfasste Traces.

So überwachen Sie Ihre KI-Funktionen, die mit Genkit implementiert wurden:

  1. Öffnen Sie nach fünf Minuten Genkit in der Firebase Console und sehen Sie sich die Promis und Antworten von Genkit an.

    Genkit stellt die folgenden Stabilitätsmesswerte zusammen:

    • Gesamtzahl der Anfragen:Die Gesamtzahl der Anfragen, die von Ihrem Flow empfangen wurden.
    • Erfolgsquote:Der Prozentsatz der Anfragen, die erfolgreich verarbeitet wurden.
    • Latenz im 95. Perzentil:Die Latenz Ihres Ablaufs im 95. Perzentil. Das ist die Zeit, die für die Verarbeitung von 95% der Anfragen benötigt wird.

    • Tokennutzung :

      • Eingabetokens: Die Anzahl der Tokens, die im Prompt an das Modell gesendet wurden.
      • Ausgabetokens: Die Anzahl der Tokens, die vom Modell in der Antwort generiert wurden.

    • Bildnutzung :

      • Eingabebilder:Die Anzahl der Bilder, die im Prompt an das Modell gesendet wurden.
      • Ausgabebilder:Die Anzahl der Bilder, die vom Modell in der Antwort generiert wurden.

    Wenn Sie die Stabilitätsmesswerte maximieren, sind detaillierte Diagramme verfügbar:

    • Anfragevolumen im Zeitverlauf
    • Erfolgsquote im Zeitverlauf
    • Eingabe- und Ausgabetokens im Zeitverlauf
    • Latenz (95. und 50. Perzentil) im Zeitverlauf

Weitere Informationen zu Genkit finden Sie unter Genkit.

App mit Firebase App Check schützen

Wenn Sie Firebase- oder Google Cloud-Dienste in Ihre App eingebunden haben, Firebase App Check schützt Ihre App-Back-Ends vor Missbrauch, indem verhindert wird, dass nicht autorisierte Clients auf Ihre Firebase-Ressourcen zugreifen. Der Dienst funktioniert sowohl mit Google-Diensten (einschließlich Firebase- und Google Cloud-Diensten) als auch mit Ihren eigenen benutzerdefinierten Back-Ends, um Ihre Ressourcen zu schützen.

Wir empfehlen, App Check jeder App hinzuzufügen, die Sie öffentlich veröffentlichen, um Ihre Back-End-Ressourcen vor Missbrauch zu schützen.

In diesem Abschnitt erfahren Sie, wie Sie App Check in Firebase Studio mit reCAPTCHA Enterprise für eine Web-App einrichten, die vom App Prototyping agent erstellt wurde. Sie können App Check aber in jeder App einrichten, in der Firebase-Dienste implementiert sind und benutzerdefinierte Anbieter implementiert werden können. Weitere Informationen finden Sie unter Firebase App Check.

Mit reCAPTCHA Enterprise erhalten Sie bis zu 10.000 kostenlose Bewertungen.

Schritt 1: reCAPTCHA Enterprise für Ihre App einrichten

  1. Öffnen Sie den reCAPTCHA Enterprise Bereich der Google Cloud Console.

  2. Wählen Sie in der Google Cloud Console Projektauswahl den Namen Ihres Firebase-Projekts aus.

  3. Wenn Sie aufgefordert werden, die reCAPTCHA Enterprise API zu aktivieren, tun Sie das.

  4. Klicken Sie auf Jetzt starten und fügen Sie einen Anzeigenamen für Ihren reCAPTCHA Websiteschlüssel hinzu.

  5. Übernehmen Sie den Standardschlüssel für den Anwendungstyp Web.

  6. Klicken Sie auf Domain hinzufügen und fügen Sie eine Domain hinzu. Fügen Sie Ihre App Hosting Domain (z. B. studio--PROJECT_ID.REGION.hosted.app) und alle benutzerdefinierten Domains hinzu, die Sie mit Ihrer App verwenden oder verwenden möchten.

  7. Klicken Sie auf Nächster Schritt.

  8. Lassen Sie Herausforderungen verwenden? deaktiviert.

  9. Klicken Sie auf Schlüssel erstellen.

  10. Kopieren und speichern Sie Ihre Schlüssel-ID und fahren Sie mit Konfigurieren App Check fort.

Schritt 2: App Check konfigurieren

  1. Öffnen Sie die Firebase Konsole und klicken Sie im Navigationsmenü auf Erstellen > App Check.

  2. Klicken Sie auf Jetzt starten und dann neben Ihrer App auf Registrieren.

  3. Klicken Sie, um reCAPTCHA zu maximieren, und fügen Sie die Schlüssel-ID ein, die Sie für reCAPTCHA Enterprise generiert haben.

  4. Klicken Sie auf Speichern.

Schritt 3: App Check zum Code hinzufügen

  1. Kehren Sie zu Firebase Studio zurück und fügen Sie in der Code Ansicht den generierten Websiteschlüssel Ihrer .env Datei hinzu:

    NEXT_PUBLIC_RECAPTCHA_SITE_KEY=RECAPTCHA_SITE_KEY

  2. Wenn Ihre Firebase-Konfiguration noch nicht in .env gespeichert ist, rufen Sie sie ab:

    • Öffnen Sie in der Firebase Konsole, die Projekteinstellungen und suchen Sie sie im Abschnitt, der Ihrer App entspricht.

    • Über das Terminal in der Code Ansicht:

      1. Melden Sie sich in Firebase an: firebase auth login
      2. Wählen Sie Ihr Projekt aus: firebase use FIREBASE_PROJECT_ID
      3. Rufen Sie die Firebase-Konfiguration ab: firebase apps:sdkconfig

  3. Fügen Sie die Konfiguration Ihrer .env-Datei hinzu, sodass sie so aussieht:

    NEXT_PUBLIC_FIREBASE_API_KEY=FIREBASE_API_KEY
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=FIREBASE_AUTH_DOMAIN
NEXT_PUBLIC_FIREBASE_PROJECT_ID=FIREBASE_PROJECT_ID
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=FIREBASE_STORAGE_BUCKET
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=FIREBASE_MESSAGING_SENDER_ID
NEXT_PUBLIC_FIREBASE_APP_ID=FIREBASE_APP_ID
NEXT_PUBLIC_RECAPTCHA_SITE_KEY=RECAPTCHA_SITE_KEY

  4. Fügen Sie App Check Ihrem App-Code hinzu. Sie können Gemini bitten, App Check mit reCAPTCHA Enterprise zu Ihrer App hinzuzufügen (geben Sie unbedingt „reCAPTCHA Enterprise“ an und prüfen Sie es noch einmal). Alternativ können Sie die Schritte unter App Check App Check ausführen.

  5. Veröffentlichen Sie Ihre Website noch einmal in App Hosting. Testen Sie Ihre Datenbank- und Authentifizierungsfunktionen, um einige Daten zu generieren.

  6. Prüfen Sie in der Firebase Console, ob App Check Anfragen empfängt. Öffnen Sie dazu Build > App Check.

  7. Klicken Sie, um Cloud Firestore zu prüfen. Nachdem Sie bestätigt haben, dass Anfragen eingehen, klicken Sie auf Erzwingen , um App Check zu erzwingen.

  8. Wiederholen Sie die Überprüfung und Erzwingung für Firebase Authentication.

Wenn Sie Ihre App nach der Registrierung für App Check in einer Umgebung ausführen möchten, die von App Check normalerweise nicht als gültig eingestuft wird, z. B. lokal während der Entwicklung oder in einer CI-Umgebung (Continuous Integration), können Sie einen Debug-Build Ihrer App erstellen, der anstelle eines echten Attestierungsanbieters den App Check Debug-Anbieter verwendet. Weitere Informationen finden Sie unter Verwenden Sie App Check mit dem Debug-Anbieter in Webanwendungen.

Nächste Schritte