Share via

Logboekregistratie van containergroepen en exemplaren met Azure Monitor-logboeken

  • Artikel

Log Analytics-werkruimten bieden een centrale locatie voor het opslaan en opvragen van logboekgegevens, niet alleen vanuit Azure-resources, maar ook on-premises resources en resources in andere clouds. Azure Container Instances bevat ingebouwde ondersteuning voor het verzenden van logboeken en gebeurtenisgegevens naar Azure Monitor-logboeken.

Als u logboek- en gebeurtenisgegevens van een containergroep wilt verzenden naar Azure Monitor-logboeken, geeft u een bestaande Log Analytics-werkruimte-id en werkruimtesleutel op bij het configureren van een containergroep.

In de volgende secties wordt beschreven hoe u een containergroep met logboekregistratie maakt en hoe u query's uitvoert op logboeken. U kunt ook een containergroep bijwerken met een werkruimte-id en werkruimtesleutel om logboekregistratie in te schakelen.

Notitie

Dit artikel is onlangs bijgewerkt waarbij Log Analytics is vervangen door de term Azure Monitor-logboeken. Logboekgegevens worden nog steeds opgeslagen in een Log Analytics-werkruimte, en worden nog steeds verzameld en geanalyseerd met dezelfde Log Analytics-service. De terminologie wordt bijgewerkt om de rol van logboeken in Azure Monitor beter te weerspiegelen. Zie Wijzigingen in Azure Monitor-terminologie voor meer informatie.

Vereisten

Als u logboekregistratie in uw containerinstanties wilt inschakelen, hebt u de volgende vereisten nodig:

Log Analytics-referenties verkrijgen

Azure Container Instances heeft toestemming nodig om gegevens te verzenden naar uw Log Analytics-werkruimte. U kunt deze machtiging verlenen en de mogelijkheid tot logboekregistratie inschakelen als u de Log Analytics-werkruimte-id en een van de sleutels ervan opgeeft (primaire of secundaire) op het moment dat u de containergroep maakt.

De Log Analytics-werkruimte-id en de primaire sleutel verkrijgt u als volgt:

  1. Navigeer in Azure Portal naar uw Log Analytics-werkruimte.
  2. Selecteer onder Instellingen het beheer van agents
  3. Noteer:
    • Werkruimte-id
    • Primaire sleutel

Containergroep maken

Nu dat u de Log Analytics-werkruimte-id en de primaire sleutel hebt, kunt u een containergroep maken die geschikt is voor logboekregistratie.

In de volgende voorbeelden ziet u twee manieren om een containergroep te maken die bestaat uit één fluentd-container : Azure CLI en Azure CLI met een YAML-sjabloon. De fluentd-container produceert verschillende uitvoerregels in de standaardconfiguratie. Omdat deze uitvoer naar de Log Analytics-werkruimte wordt verzonden, is deze heel geschikt is om te illustreren hoe logboeken kunnen worden weergegeven en hoe er query's op kunnen worden uitgevoerd.

Implementeren met Azure CLI

Als u Azure CLI wilt gebruiken om te implementeren, moet u de parameters --log-analytics-workspace en --log-analytics-workspace-key opgeven in de opdracht az container create. Vervang de twee werkruimtewaarden door de waarden die u hebt verkregen in de vorige stap (en werk de naam van de resourcegroep bij) voordat u de volgende opdracht gaat uitvoeren.

Notitie

In het volgende voorbeeld wordt een openbare containerinstallatiekopie opgehaald uit Docker Hub. U wordt aangeraden een pull-geheim in te stellen voor verificatie met behulp van een Docker Hub-account in plaats van een anonieme pull-aanvraag te maken. Als u de betrouwbaarheid wilt verbeteren bij het werken met openbare inhoud, importeert en beheert u de installatiekopieën in een privé-Azure-containerregister. Meer informatie over het werken met openbare afbeeldingen.

az container create \
    --resource-group myResourceGroup \
    --name mycontainergroup001 \
    --image fluent/fluentd:v1.3-debian-1 \
    --log-analytics-workspace <WORKSPACE_ID> \
    --log-analytics-workspace-key <WORKSPACE_KEY>

Implementeren met YAML

Gebruik deze methode als u liever containergroepen met YAML wilt implementeren. Met de volgende YAML wordt een containergroep met een enkele container gedefinieerd. Kopieer de YAML naar een nieuw bestand en vervang LOG_ANALYTICS_WORKSPACE_ID en LOG_ANALYTICS_WORKSPACE_KEY door de waarden die u hebt verkregen in de vorige stap. Sla het bestand op als deploy-aci.yaml.

Notitie

In het volgende voorbeeld wordt een openbare containerinstallatiekopie opgehaald uit Docker Hub. U wordt aangeraden een pull-geheim in te stellen voor verificatie met behulp van een Docker Hub-account in plaats van een anonieme pull-aanvraag te maken. Als u de betrouwbaarheid wilt verbeteren bij het werken met openbare inhoud, importeert en beheert u de installatiekopieën in een privé-Azure-containerregister. Meer informatie over het werken met openbare afbeeldingen.

apiVersion: 2019-12-01
location: eastus
name: mycontainergroup001
properties:
  containers:
  - name: mycontainer001
    properties:
      environmentVariables: []
      image: fluent/fluentd:v1.3-debian-1
      ports: []
      resources:
        requests:
          cpu: 1.0
          memoryInGB: 1.5
  osType: Linux
  restartPolicy: Always
  diagnostics:
    logAnalytics:
      workspaceId: LOG_ANALYTICS_WORKSPACE_ID
      workspaceKey: LOG_ANALYTICS_WORKSPACE_KEY
tags: null
type: Microsoft.ContainerInstance/containerGroups

Voer vervolgens de volgende opdracht uit om de containergroep te implementeren. Vervang myResourceGroup door een resourcegroep in uw abonnement (of maak eerst een resourcegroep met de naam 'myResourceGroup'):

az container create --resource-group myResourceGroup --name mycontainergroup001 --file deploy-aci.yaml

Kort nadat u de opdracht hebt opgegeven, zou u een reactie van Azure met implementatiedetails moeten ontvangen.

Logboeken weergeven

Nadat u de containergroep hebt geïmplementeerd, kan het enkele minuten (maximaal 10) duren voordat de eerste logboekvermeldingen worden weergegeven in Azure Portal.

Ga als volgt te werk om de logboeken van de containergroep in de tabel weer te ContainerInstanceLog_CL geven:

  1. Navigeer in Azure Portal naar uw Log Analytics-werkruimte.
  2. Selecteer logboeken onder Algemeen
  3. Typ de volgende query: ContainerInstanceLog_CL | limit 50
  4. Uitvoeren selecteren

U ziet nu enkele resultaten die door de query worden weergegeven. Als u eerst geen resultaten ziet, wacht u enkele minuten en selecteert u vervolgens de knop Uitvoeren om de query opnieuw uit te voeren. Logboekvermeldingen worden standaard weergegeven in tabelindeling . U kunt vervolgens een rij uitbreiden om de inhoud van een afzonderlijke logboekvermelding te zien.

Resultaten van zoekopdrachten in logboeken in Azure Portal

Gebeurtenissen weergeven

U kunt ook gebeurtenissen voor containerinstanties weergeven in Azure Portal. Gebeurtenissen omvatten de tijd waarop het exemplaar wordt gemaakt en wanneer het wordt gestart. De gebeurtenisgegevens in de ContainerEvent_CL tabel weergeven:

  1. Navigeer in Azure Portal naar uw Log Analytics-werkruimte.
  2. Selecteer logboeken onder Algemeen
  3. Typ de volgende query: ContainerEvent_CL | limit 50
  4. Uitvoeren selecteren

U ziet nu enkele resultaten die door de query worden weergegeven. Als u eerst geen resultaten ziet, wacht u enkele minuten en selecteert u vervolgens de knop Uitvoeren om de query opnieuw uit te voeren. Standaard worden vermeldingen weergegeven in tabelindeling . Vervolgens kunt u een rij uitvouwen om de inhoud van een afzonderlijke vermelding weer te geven.

Resultaten van gebeurteniszoekopdrachten in De Azure-portal

Query's uitvoeren op containerlogboeken

Azure Monitor-logboeken bevat een uitgebreide querytaal voor het ophalen van gegevens uit mogelijk duizenden regels aan logboekuitvoer.

De basisstructuur van een query is de brontabel (in dit artikel ContainerInstanceLog_CL of ContainerEvent_CL) gevolgd door een reeks operatoren gescheiden door het pipeteken (|). U kunt verschillende operatoren aan elkaar koppelen om de resultaten te verfijnen en geavanceerde functies uit te voeren.

Als u voorbeeldqueryresultaten wilt zien, plakt u de volgende query in het tekstvak van de query en selecteert u de knop Uitvoeren om de query uit te voeren. Deze query geeft alle logboekvermeldingen weer waarvan het veld 'Bericht' het woord 'waarschuwen' bevat:

ContainerInstanceLog_CL
| where Message contains "warn"

Complexere query's worden ook ondersteund. Met deze query worden bijvoorbeeld de logboekvermeldingen voor de containergroep 'mycontainergroup001' weergegeven die het afgelopen uur zijn gegenereerd:

ContainerInstanceLog_CL
| where (ContainerGroup_s == "mycontainergroup001")
| where (TimeGenerated > ago(1h))

Logboekschema

Zie Verouderde Log Analytics-tabellen voor meer informatie over het verouderde Azure Monitor-schema voor Log Analytics.

Diagnostische instellingen gebruiken

Voor de nieuwere tabellen is het gebruik van diagnostische instellingen vereist om informatie naar Log Analytics te routeren. De functie voor diagnostische instellingen voor Container Instances bevindt zich in openbare preview en kan worden ingeschakeld via preview-functies in Azure Portal.

Zie Azure Monitor Log Analytics-tabellen voor meer informatie.

Volgende stappen

Azure Monitor-logboeken

Voor meer informatie over het uitvoeren van query's op logboeken en het configureren van waarschuwingen in Azure Monitor-logboeken, zie:

CPU en geheugen van een container bewaken

Voor informatie over het bewaken van CPU- en geheugenresources van containerinstanties, zie: