Konfigurera kommunikationshanterare för Azure Kubernetes Service

Kommunikationshanteraren för Azure Kubernetes Service (AKS) effektiviserar meddelanden för alla dina AKS-underhållsaktiviteter med hjälp av Azure Resource Notifications och Azure Resource Graph-ramverk. Kommunikationshanteraren ger dig aviseringar i tid om händelseutlösare och resultat, så att du noggrant kan övervaka dina uppgraderingar.

Om underhållet misslyckas meddelar kommunikationshanteraren dig om orsaken till felet. Den här informationen minskar driftproblem som rör observerbarhet och uppföljningar.

Genom att följa stegen i den här artikeln kan du konfigurera aviseringar för uppgraderingshändelser i ett AKS-kluster. Frågorna filtrerar schemalagda händelser efter klusterresurs-ID. de övervakar inte Fleet Manager-uppdateringskörningar. Om du konfigurerar uppgraderingar via en autouppgraderingsprofil och strategi för Fleet Manager, se Övervaka uppdateringskörningar i Fleet Manager.

  • Automatiska uppgraderingar som du konfigurerar på klustret och som följer dess planerade underhållsperiod.
  • Plattformsinitierade uppgraderingar, som AKS kör på kluster som har en Kubernetes-version som inte stöds efter plattformens respitperiod. De här uppgraderingarna kan ske utanför underhållsfönstret.

Förutsättningar

Konfigurera kommunikationshanteraren

  1. Gå till resursen i Azure-portalen.

  2. VäljÖvervakningsaviseringar>>Aviseringsregler och välj sedan Skapa.

  3. På fliken Villkor för Signalnamn väljer du Anpassad loggsökning.

    Skärmbild som visar valet av en anpassad loggsökning i fönstret för att skapa en aviseringsregel.

  4. I rutan Sökfråga klistrar du in en av följande anpassade frågor. Se till att uppdatera where id contains sökvägen för att referera till dina resurser för prenumerations-ID, resursgruppsnamn och klusternamn.

    Följande fråga gäller meddelanden om automatiska uppgraderingar för kluster:

    arg("").containerserviceeventresources
    | where type == "microsoft.containerservice/managedclusters/scheduledevents"
    | where id contains "/subscriptions/<subid>/resourcegroups/<rgname>/providers/Microsoft.ContainerService/managedClusters/<clustername>"
    | where properties has "eventStatus"
    | extend status = substring(properties, indexof(properties, "eventStatus") + strlen("eventStatus") + 3, 50)
    | extend status = substring(status, 0, indexof(status, ",") - 1)
    | where status != ""
    | where properties has "eventDetails"
    | extend upgradeType = case(
                               properties has "K8sVersionUpgrade",
                               "K8sVersionUpgrade",
                               properties has "NodeOSUpgrade",
                               "NodeOSUpgrade",
                               ""
                           )
    | extend details = parse_json(tostring(properties.eventDetails))
    | where properties has "lastUpdateTime"
    | extend eventTime = substring(properties, indexof(properties, "lastUpdateTime") + strlen("lastUpdateTime") + 3, 50)
    | extend eventTime = substring(eventTime, 0, indexof(eventTime, ",") - 1)
    | extend eventTime = todatetime(tostring(eventTime))
    | where eventTime >= ago(30m) // Ensure this matches aggregation granularity & frequency
    | where upgradeType == "K8sVersionUpgrade"
    | project
        eventTime,
        upgradeType,
        status,
        properties,
        name,
        details
    | order by eventTime asc
    

    Följande fråga gäller meddelanden om automatiska uppgraderingar för NodeOS:

    arg("").containerserviceeventresources
    | where type == "microsoft.containerservice/managedclusters/scheduledevents"
    | where id contains "/subscriptions/<subid>/resourcegroups/<rgname>/providers/Microsoft.ContainerService/managedClusters/<clustername>"
    | where properties has "eventStatus"
    | extend status = substring(properties, indexof(properties, "eventStatus") + strlen("eventStatus") + 3, 50)
    | extend status = substring(status, 0, indexof(status, ",") - 1)
    | where status != ""
    | where properties has "eventDetails"
    | extend upgradeType = case(
                               properties has "K8sVersionUpgrade",
                               "K8sVersionUpgrade",
                               properties has "NodeOSUpgrade",
                               "NodeOSUpgrade",
                               ""
                           )
    | extend details = parse_json(tostring(properties.eventDetails))
    | where properties has "lastUpdateTime"
    | extend eventTime = substring(properties, indexof(properties, "lastUpdateTime") + strlen("lastUpdateTime") + 3, 50)
    | extend eventTime = substring(eventTime, 0, indexof(eventTime, ",") - 1)
    | extend eventTime = todatetime(tostring(eventTime))
    | where eventTime >= ago(30m) // Ensure this matches aggregation granularity & frequency
    | where upgradeType == "NodeOSUpgrade"
    | project
        eventTime,
        upgradeType,
        status,
        properties,
        name,
        details
    | order by eventTime asc
    
  5. Gå till fliken Villkor . Konfigurera aviseringsvillkoren med följande inställningar:

    • Mått: Välj Tabellrader.
    • Sammansättningstyp: Välj Antal.
    • Sammansättningskornighet: Välj 30 minuter.
    • Tröskelvärde: Behåll vid 0.
    • Dela efter dimensioner: För Dimensionsnamn väljer du status. Markera sedan kryssrutan Inkludera alla framtida värden .

    Skärmbild av konfigurationsalternativen för aviseringsvillkor.

  6. I området Dela efter dimensioner väljer du ett värde för Dimensionsvärden. Eftersom du har valt status för dimensionsnamnet är de tillgängliga värdena Schemalagda, Startade, Slutförda, Avbrutna och Misslyckade.

    Anmärkning

    Dessa statusvärden visas endast om klustret tidigare utförde automatiska uppgraderingsåtgärder. För nya kluster eller för kluster som inte har genomgått automatiska uppgraderingar ännu kan listrutan visas tom eller visa inga tillgängliga dimensioner. När klustret har slutfört sin första automatiska uppgradering blir dessa statusvärden tillgängliga för markering.

    Skärmbild av listrutorna i området för delning efter dimensioner.

  7. Gå till fliken Åtgärder . Kontrollera att det finns en åtgärdsgrupp med rätt e-postadress så att du kan ta emot aviseringarna:

    1. Välj Använd åtgärdsgrupper>Skapa en åtgärdsgrupp.

    2. Som Meddelandetyp väljer du E-post/SMS_message/Push/Röst.

    3. Markera kryssrutan E-post och ange sedan e-postadressen i rutan E-post .

      Skärmbild av fönstret för att ange e-postinformation för en åtgärdsgrupp.

  8. Gå till fliken Information . Tilldela en hanterad identitet så att du kan ge åtkomst till nödvändiga resurser. I området Identitet väljer du Systemtilldelad hanterad identitet.

    Skärmbild som visar val för att tilldela en systemtilldelad hanterad identitet.

  9. Gå till fliken Granska + skapa och välj sedan Skapa.

  10. Nu när du har skapat aviseringsregeln kan du tilldela lämpliga roller för den hanterade identiteten:

    1. I aviseringsregeln går du till Inställningar>Identitet>Systemtilldelad hanterad identitet>.
    2. Välj Lägg till rolltilldelning, välj rollen Läsare och tilldela den till resursgruppen.
    3. Välj Lägg till rolltilldelning igen, välj rollen Läsare och tilldela den till prenumerationen.

    Tips/Råd

    Om du inte ser alternativet Identitet kontrollerar du att du har skapat aviseringsregeln och att du har nödvändiga behörigheter.

När du har konfigurerat kommunikationshanteraren skickar den förhandsmeddelanden en vecka innan underhållet startar och en dag innan underhållet startar. Du får också aviseringar i tid under underhållsåtgärden.

Verifiera konfigurationen

Om du vill uppgradera klustret väntar du på att den automatiska uppgraderingen ska starta. Kontrollera sedan att du snabbt får meddelanden om den e-postadress som du har konfigurerat för att ta emot meddelanden.

Kontrollera Azure Resource Graph-databasen för den schemalagda meddelandeposten. Varje schemalagd händelseavisering bör anges som en post i ContainerServiceEventResources tabellen.

Skärmbild som visar en meddelandepost i Azure Resource Graph.