Instellen dat servicelogboeken worden geëxporteerd naar BigQuery

Deze functie wordt ondersteund in de volgende versies: Frontline Standard en Frontline Plus, Enterprise Standard en Enterprise Plus, Education Standard en Education Plus, Enterprise Essentials Plus. Versies vergelijken

Als u gebeurtenissen in het activiteitenlogboek (afzonderlijke acties die een gebruiker heeft uitgevoerd) en gebruiksrapporten (verzamelrapporten voor een app) wilt exporteren naar Google BigQuery, moet u een BigQuery Export-configuratie instellen in de Google Beheerdersconsole.

Over BigQuery- en Reports API-gegevens

De gegevens die beschikbaar zijn in de BigQuery-dataset, verschillen van de gegevens die worden opgehaald uit de Reporting API. De BigQuery-gegevens bevatten alleen de ongefilterde dataset. U kunt de gegevens nog steeds filteren met SQL, maar niet alle parameters uit de Reports API worden ondersteund.

U kunt de Reports API-gegevens filteren door parameters toe te voegen aan het API-verzoek.

Voorbeeld: Er bevinden zich 2 organisatie-eenheden (OE's) in een domein: A en B. Met de Reports API en BigQuery heeft u toegang tot alle gebeurtenissen voor het hele domein (A en B).

• Met de Reports API kunt u de gebeurtenissen uit OE A ophalen door de parameter orgUnitID in het API-verzoek te gebruiken.
• Met SQL en BigQuery kunt u gebeurtenissen niet filteren op organisatie-eenheid, omdat er geen bijbehorende kolom is voor de parameter orgUnitID.

Belangrijk:

• De BigQuery-gegevens bevatten historische gegevens die u ook kunt ophalen uit de Reports API.
• Als u de export van Google Workspace-gegevens naar BigQuery uitzet, worden er geen nieuwe gegevens meegenomen in BigQuery Export. Bestaande gegevens zijn echter beschikbaar in andere bronnen, zoals de Reports API.
• Niet alle gegevens uit servicerapporten zijn beschikbaar in BigQuery Export. Ga naar Welke services worden ondersteund door BigQuery Export? voor een lijst met ondersteunde services.
• Ga naar Voorbeeldquery's voor rapportlogboeken in BigQuery voor voorbeelden van query's.

Hoe gegevens worden doorgestuurd en bewaard

• Het kan een uur duren voordat het beleid is doorgestuurd. Daarna worden de dagelijkse tabellen gemaakt in de dataset (Pacific Time).
• Gegevens worden opgeslagen volgens de richtlijnen voor andere logboeken en rapporten. Ga naar Bewaartijden van gegevens en vertragingstijden voor meer informatie.
• Gegevenstabellen worden niet automatisch verwijderd. Ga naar Een BigQuery Export-configuratie verwijderen om een actief project te verwijderen.
• BigQuery Export verzamelt Google Workspace-gegevens van gebeurtenissen van de vorige dag. In de resultaten staan de gegevens van de dag voorafgaand aan de exportdatum.

Een BigQuery Export-configuratie instellen

Stel eerst in de Google Cloud Console een BigQuery-project in. Doe het volgende als u het project maakt:

• Voeg een Google Workspace-beheerdersaccount toe als projectbewerker of met een vergelijkbare rol voor identiteits- en toegangsbeheer (IAM).
• Voeg het serviceaccount [email protected] toe als projectbewerker (of een vergelijkbare IAM-rol). U heeft dit nodig om logboeken te schrijven, het schema te updaten en later stap 6 uit te voeren.

Ga naar Een BigQuery-project instellen voor rapportlogboeken voor instructies.

1. Log in met een hoofdbeheerdersaccount op de Google Beheerdersconsole.

   Als u geen hoofdbeheerdersaccount gebruikt, kunt u deze stappen niet uitvoeren.

2. Ga naar Menu  Rapportage > Gegevensintegraties.

   Hiervoor is het beheerdersrecht Rapporten vereist.

   Onderwijsbeheerders gaan naar Menu   RapportageBigQuery Export. Hiermee wordt de pagina Gegevensintegraties geopend.

3. Plaats de muisaanwijzer op de kaart BigQuery Export en klik op Bewerken .
4. Vink het vakje aan voor Exporteren van Google Workspace-gegevens naar Google BigQuery aanzetten om BigQuery-logboeken te activeren.

5. (Optioneel) Als u gevoelige parameters van DLP-regels wilt exporteren, vinkt u het vakje aan voor Exports van gevoelige content uit DLP-regellogboeken toestaan. Ga naar Content bekijken waardoor DLP-regels worden getriggerd voor meer informatie.

6. Selecteer onder Project-ID BigQuery het project waarin u de logboeken wilt opslaan. Kies een project waarvoor [email protected] de rol Bewerker of een vergelijkbare IAM-rol heeft. Als u het project niet ziet, moet u het instellen in BigQuery. Ga naar Quickstart using the Cloud Console (Snel aan de slag via de Cloud Console) voor meer informatie.
7. Voer onder Nieuwe dataset in project de naam in van de dataset waarin de logboeken in het project moeten worden opgeslagen. De naam van de dataset moet uniek zijn voor elk project. Ga naar Datasets maken voor meer informatie.
8. Klik op Opslaan.
   Opmerking: Als u het project niet kunt opslaan, gaat u naar de Google Cloud Console. Verwijder de nieuwe dataset en sla het project opnieuw op in de Beheerdersconsole.

Als de export wordt geactiveerd, wordt de dataset de volgende dag gemaakt. Naast projecteigenaren, bewerkers en kijkers wordt het serviceaccount [email protected] toegevoegd als bewerker. Het serviceaccount is vereist om logboeken te maken en het schema te updaten.

Vereisten voor de export van logboekgegevens

Logboekgegevens worden geëxporteerd via de insertAll API. Hiervoor moet facturering aanstaan voor uw BigQuery Export-project. Als facturering niet aanstaat, bevindt uw project zich in de sandbox-modus en worden de logboekgegevens niet geëxporteerd naar uw dataset. Ga naar Beperkingen voor meer informatie.

Opmerking: Export van gebruiksrapporten staat nog steeds aan voor projecten in de sandboxmodus.

Vertragingstijden

Nadat u de export van gegevens naar BigQuery heeft aangezet, zijn gebeurtenissen in het Activiteitenlogboek meestal binnen 10 minuten beschikbaar. Gebeurtenissen in het gebruikslogboek hebben een vertraging van 48 uur bij de eerste configuratie, maar daarna is de gebruikelijke vertraging 1 tot 3 dagen.Ga naar Bewaartijden van gegevens en vertragingstijden voor meer informatie.

Veelgestelde vragen

Gerelateerd onderwerp