Delen via

Opties voor logboekopslag en bewaking in Azure Container Apps

Azure Container Apps biedt u opties voor het opslaan en weergeven van uw toepassingslogboeken. U kunt opties voor logboekregistratie configureren op het niveau van de Container Apps-omgeving. Als u Azure Monitor selecteert als de bestemming van uw logboeken, kunt u diagnostische instellingen configureren op zowel het niveau van de omgeving als op het niveau van de container-app.

Toepassingslogboeken van Container Apps bestaan uit twee verschillende categorieën:

  • Console-uitvoerberichten van de container (stdout/stderr).
  • Systeemlogboeken gegenereerd door Azure Container Apps.
  • Spring App-consolelogboeken.

U kunt kiezen tussen deze logboekbestemmingen:

  • Log Analytics: Azure Monitor Log Analytics is de standaardopslag en weergaveoptie. Uw logboeken worden opgeslagen in een Log Analytics-werkruimte waar ze kunnen worden bekeken en geanalyseerd met behulp van Log Analytics-query's. Zie Azure Monitor Log Analytics voor meer informatie over Log Analytics.
  • Azure Monitor: Azure Monitor routeert logboeken naar een of meer bestemmingen:
    • Log Analytics-werkruimte voor weergave en analyse.
    • Azure Storage-account dat moet worden gearchiveerd.
    • Azure Event Hub voor gegevensopname- en analyseservices. Zie Azure Event Hubs voor meer informatie.
    • Een bewakingsoplossing voor Azure-partners, zoals Datadog, Elastic, Logz.io en andere. Zie Partner-oplossingen voor meer informatie.
  • Sla geen logboeken op: u kunt de opslag van logboekgegevens uitschakelen. Wanneer deze optie is uitgeschakeld, kunt u nog steeds realtime containerlogboeken weergeven via de functie Logboekenstroom in uw container-app. Zie Logboekstreaming voor meer informatie.

Wanneer Logboeken niet opslaan of de bestemming Azure Monitor is geselecteerd, wordt het menu-item Logboeken dat zorgt voor de Log Analytics-queryeditor in het Azure portal uitgeschakeld.

Opties voor logboekregistratie configureren

Gebruik deze stappen om de logboekregistratieopties voor uw omgeving te configureren in Azure Portal:

  1. Blader naar uw Container Apps-omgeving in de portal.

  2. Selecteer Bewaking>Logboekopties.

  3. U kunt kiezen uit de volgende logbestemmingen opties:

    • Azure Log Analytics: Met deze optie selecteert u een Log Analytics-werkruimte om uw logboekgegevens op te slaan. Uw logboeken kunnen worden weergegeven via Log Analytics-query's. Zie Azure Monitor Log Analytics voor meer informatie over Log Analytics.
    • Azure Monitor: Azure Monitor stuurt uw logboeken naar een bestemming. Wanneer u deze optie selecteert, moet u diagnostische instellingen selecteren om de configuratie te voltooien nadat u Opslaan op deze pagina hebt geselecteerd.
    • Sla geen logboeken op: met deze optie wordt de opslag van logboekgegevens uitgeschakeld.

  4. Selecteer Opslaan.

Diagnostische instellingen

Als u Azure Monitor hebt geselecteerd als de bestemming van uw logboeken, moet u ook de diagnostische instellingen configureren. U kunt de diagnostische instellingen configureren op zowel het niveau van de omgeving als het niveau van de container-app.

Diagnostische instellingen configureren op omgevingsniveau

Gebruik deze stappen om de diagnostische instellingen voor uw omgeving te configureren:

  1. Blader naar uw omgeving in de portal.

  2. Selecteer Diagnostische . Als u de logboeken van uw omgeving zojuist hebt ingesteld naar Azure Monitor, moet u mogelijk de pagina vernieuwen om dit configuratie-item beschikbaar te maken.

Doeldetails worden opgeslagen als diagnostische instellingen. U kunt maximaal vijf diagnostische instellingen voor uw omgeving maken. U kunt verschillende logboekcategorieën configureren voor elke diagnostische instelling. Maak bijvoorbeeld een diagnostische instelling om de categorie systeemlogboeken naar de ene bestemming te verzenden en een andere om de categorie containerconsolelogboeken naar een andere bestemming te verzenden.

Om een nieuwe diagnostische instelling te maken:

  1. Selecteer Diagnostische instellingen toevoegen.

  2. Voer in de naam van de diagnostische instelling een naam in voor uw diagnostische instelling.

  3. Selecteer de logboekcategoriegroepen of categorieën die u naar deze bestemming wilt verzenden. U kunt een of meer categorieën selecteren.

  4. Als u metrische gegevens op app-niveau wilt verzenden, selecteert uAllMetrics>voor metrische gegevens.

  5. Selecteer een of meer doelgegevens:

    • Verzenden naar Log Analytics-werkruimte: Selecteer een van de bestaande Log Analytics-werkruimten.
    • Archiveren naar een opslagaccount: selecteer een keuze uit Azure-opslagaccounts.
    • Streamen naar een Event Hub: Selecteer uit Azure Event Hubs.
    • Verzenden naar een partneroplossing: Selecteer een van de Azure-partneroplossingen.

  6. Selecteer Opslaan.

Zie Diagnostische instellingen in Azure Monitor voor meer informatie over diagnostische instellingen.

Diagnostische instellingen configureren op het niveau van de container-app

Gebruik deze stappen om de diagnostische instellingen voor uw container-app te configureren:

  1. Blader naar uw container-app in het portaal.

  2. Selecteer Diagnostische . Als u zojuist de logbestemming van de container-app-omgeving hebt ingesteld op Azure Monitor, kan het zijn dat u de pagina moet vernieuwen om dit configuratie-item weer te geven.

  3. Selecteer Diagnostische instellingen toevoegen.

  4. Voer in de naam van de diagnostische instelling een naam in voor uw diagnostische instelling.

  5. Selecteer onder Metrische gegevens AllMetrics.

  6. Selecteer een of meer doelgegevens:

    • Verzenden naar Log Analytics-werkruimte: Selecteer een van de bestaande Log Analytics-werkruimten.
    • Archiveren naar een opslagaccount: Selecteer een opslagaccount.
    • Streamen naar een Event Hub: Selecteer uit Azure Event Hubs.
    • Verzenden naar een partneroplossing: Selecteer een van de Azure-partneroplossingen.

  7. Selecteer Opslaan.

Opties voor logboekregistratie configureren

Configureer de logbestemming voor uw Container Apps-omgeving met behulp van de Azure CLI az containerapp create en az containerapp update opdrachten met het --logs-destination argument.

Registreer eerst de Microsoft.Insights naamruimte.

az provider register --namespace Microsoft.Insights

Verzenden naar een Log Analytics-werkruimte

Als u een Container Apps-omgeving wilt maken met behulp van een bestaande Log Analytics-werkruimte als de doellogboeken, voert u de volgende opdracht uit. Vervang de <PLACEHOLDERS> waarden door uw waarden. U kunt de resource-id van de Log Analytics-werkruimte ophalen op de pagina Log Analytics-werkruimte in Azure Portal of via de az monitor log-analytics workspace show opdracht.

az containerapp env create \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --logs-destination log-analytics \
  --logs-workspace-id <LOG_ANALYTICS_WORKSPACE_ID>

Het --logs-destination argument accepteert de waarden log-analytics, azure-monitoren none.

Verzenden naar Azure Monitor

Voer de volgende opdracht uit om een bestaande Container Apps-omgeving bij te werken voor het gebruik van Azure Monitor als de doellocatie van de logboeken. Vervang de <PLACEHOLDERS> waarden door uw waarden:

az containerapp env update \
  --name <ENVIRONMENT_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --logs-destination azure-monitor

Diagnostische instellingen configureren

Wanneer --logs-destination is ingesteld op azure-monitor, moet u diagnostische instellingen maken om doelgegevens te configureren voor de logcategorieën met de az monitor diagnostics-settings opdracht. U kunt deze diagnostische instellingen configureren op zowel het niveau van de omgeving als het niveau van de container-app.

Voer de volgende opdracht uit om diagnostische instellingen te maken op omgevingsniveau. Vervang de <PLACEHOLDERS> waarden door uw waarden. U kunt de omgevings-id ophalen op de pagina Omgeving in Azure Portal of via de az containerapp env show opdracht.

az monitor diagnostic-settings create \
  --name "AllMetricsToLogAnalytics" \
  --resource <ENVIRONMENT_ID> \
  --logs '[{"categoryGroup":"allLogs","enabled":true}]' \
  --metrics '[{"category":"AllMetrics","enabled":true}]' \
  --workspace <LOG_ANALYTICS_RESOURCE_ID>

Zorg ervoor dat er geen spaties in de JSON-waarden zijn opgegeven voor de --logs en --metrics parameters.

Voor de --logs parameter kunt u opgeven category of categoryGroup, maar niet beide tegelijk. Voor categoryGroup, de beschikbare waarden zijn audit en allLogs. Voor category, de beschikbare waarden zijn ContainerAppConsoleLogs en ContainerAppSystemLogs.

Voor de --metrics parameter is AllMetricsde enige beschikbare categorie.

Zie LogSettings en MetricSettings voor meer informatie.

Voer de volgende opdracht uit om diagnostische instellingen te maken op het niveau van de container-app. Vervang de <PLACEHOLDERS> waarden door uw waarden. U kunt de id van de container-app ophalen vanuit Azure Portal of via de az containerapp show opdracht.

Bij het maken van diagnostische instellingen op container-app-niveau wordt de --logs parameter niet ondersteund en voor de --metrics parameter is AllMetricsde enige beschikbare categorie.

az monitor diagnostic-settings create \
--name "AllMetricsToLogAnalytics" \
--resource <CONTAINER_APP_ID> \
--metrics '[{"category":"AllMetrics","enabled":true}]' \
--workspace <LOG_ANALYTICS_RESOURCE_ID>

Zie az monitor diagnostic-settings voor meer informatie over opdrachten voor diagnostische instellingen van Azure Monitor.

Beperkingen

De volgende beperkingen gelden voor het instellen van de logboekopties.

  • Privékoppeling: het rechtstreeks verzenden van logboeken naar een Log Analytics-werkruimte via Private Link wordt niet ondersteund. U kunt echter Azure Monitor gebruiken en uw logboeken verzenden naar dezelfde Log Analytics-werkruimte. Deze indirectie is vereist om gegevensverlies van systeemlogboeken te voorkomen.

Volgende stappen

Logboeken bewaken met Log Analytics

  • Last updated on