Vlastní relace kontejnerů Azure Container Apps

Kromě integrovaného interpretu kódu, který poskytují dynamické relace Azure Container Apps, můžete také použít vlastní kontejnery k definování vlastních sandboxů relací.

Poznámka:

Tento článek se týká pouze vlastních fondů relací kontejnerů. Pokud není uvedeno jinak, nejsou funkce popsané tady dostupné pro fondy relací interpretu kódu.

Používá se pro vlastní relace kontejneru.

Vlastní kontejnery umožňují vytvářet řešení přizpůsobená vašim potřebám. Umožňují spouštět kód nebo aplikace v prostředích, která jsou rychlá a dočasné. Nabízejí zabezpečené sandboxové prostory s Hyper-V. Je také možné je nakonfigurovat s volitelnou izolací sítě. Mezi některé příklady patří:

  • Interprety kódu: Používá se, pokud spouštíte nedůvěryhodný kód v zabezpečených sandboxech jazykem, který není podporovaný v integrovaném interpretu, nebo potřebujete plnou kontrolu nad prostředím interpretu kódu.

  • Izolované spouštění: Používá se, pokud spouštíte aplikace v nehostinných scénářích s více tenanty, ve kterých má každý tenant nebo uživatel vlastní prostředí v izolovaném prostoru (sandbox). Tato prostředí jsou izolovaná od sebe a od hostitelské aplikace. Mezi příklady patří aplikace, které spouštějí uživatelský kód, kód, který koncovým uživatelům uděluje přístup ke cloudovým prostředím, agentům AI a vývojovým prostředím.

Použití vlastních relací kontejneru

Pokud chcete použít vlastní relace kontejneru, vytvořte fond relací s vlastním obrazem kontejneru. Azure Container Apps automaticky spouští kontejnery ve vlastních sandboxech Hyper-V pomocí poskytnuté image. Po spuštění kontejneru je kontejner dostupný pro fond relací.

Když aplikace požádá o relaci, instance se okamžitě přidělí z fondu. Relace zůstane aktivní, dokud nezajde do nečinného stavu, který se pak automaticky zastaví a zničí.

Sondy kontejnerů pro fondy relací

Pomocí sond kontejnerů můžete nakonfigurovat kontroly stavu pro vlastní fondy relací kontejnerů a udržovat instance relací, které jsou v pořádku.

Poznámka:

Sondy pro kontejnery vyžadují verzi rozhraní API 2025-02-02-preview nebo novější.

Sondy kontejnerů umožňují definovat kontroly stavu pro kontejnery relací, podobně jako sondy stavu v Azure Container Apps. Při konfiguraci fond relací monitoruje každou instanci relace a odebere instance, které nejsou v pořádku.

Pool relací

  • Zajišťuje, že instance připravených relací jsou v pořádku na základě sond.
  • Automaticky odebere nezdravé instance relací.
  • Navyšuje kapacitu, aby se zachoval nakonfigurovaný readySessionInstances počet zdravých relací.

Fondy relací podporují sondy typu Liveness a Startup. Další informace o tom, jak fungují sondy, najdete v tématu Sondy stavu v Azure Container Apps.

Konfigurace

Při vytváření nebo aktualizaci fondu relací zadejte sondy v properties.customContainerTemplate.containers části datového požadavku.

Úplnou specifikaci rozhraní API najdete v tématu Rozhraní API SessionPools.

Příklad

{
  "properties": {
    "customContainerTemplate": {
      "containers": [
        {
          "name": "my-session-container",
          "image": "myregistry.azurecr.io/my-session-image:latest",
          "probes": [
            {
              "type": "Liveness",
              "httpGet": {
                "path": "/health",
                "port": 8080
              },
              "periodSeconds": 10,
              "failureThreshold": 3
            },
            {
              "type": "Startup",
              "httpGet": {
                "path": "/ready",
                "port": 8080
              },
              "periodSeconds": 5,
              "failureThreshold": 30
            }
          ]
        }
      ]
    },
    "dynamicPoolConfiguration": {
      "readySessionInstances": 5
    }
  }
}

Troubleshooting

Pokud váš fond relací neudržuje očekávaný počet zdravých readySessionInstances, zvažte následující řešení:

  • Zkontrolujte protokoly kontejneru. Zkontrolujte protokoly kontejneru relací a identifikujte problémy s koncovými body sondy nebo spuštěním kontejneru. Podívejte se na Zobrazení protokolů pro vlastní fondy relací kontejnerů.
  • Ověřte konfiguraci sondy. Ujistěte se, že jsou pro vaši aplikaci správně nakonfigurované cesty sondy, porty a prahové hodnoty.
  • Zkontrolujte stav kontejneru. Zkontrolujte problémy v kontejneru, které brání úspěšnému odezvě koncových bodů sondy.

Zastavení relace

Pomocí Stop Session API ukončete relaci ve vlastním fondu kontejnerových relací.

Fondy relací podporují automatickou správu relací prostřednictvím lifecycleConfiguration, která zpracovává životní cyklus relace na základě vaší konfigurace. Existují však scénáře, ve kterých můžete potřebovat větší kontrolu.

Po přidělení relace můžete toto rozhraní API volat a relaci kdykoli ručně ukončit. Tento přístup je užitečný v těchto případech:

  • Prostředky je potřeba vyčistit, než relace dosáhne svého času naživo.
  • Váš fond relací dosáhne maximálního limitu souběžných relací a potřebujete uvolnit kapacitu pro nové relace.
  • Sezení dokončí svou práci a chcete okamžitě uvolnit zdroje.

Referenční informace k rozhraní API

Prosba

POST {PoolManagementEndpoint}/.management/stopSession?api-version=2025-10-02-preview&identifier={SessionIdentifier}

Parametry

Parameter Typ Povinné Popis
api-version řetězec Ano Verze rozhraní API, 2025-10-02-previewkterá se má použít (například).
identifier řetězec Ano Jedinečný identifikátor relace, která se má zastavit.

Příklady

Prosba

POST https://{PoolManagementEndpoint}/.management/stopSession?api-version=2025-10-02-preview&identifier=testSessionIdentifier

odpověď

HTTP/1.1 200 OK
Content-Type: text/plain

Session testSessionIdentifier in session pool testSessionPool stopped.

Logging

Vlastní pooly relací kontejnerů se integrují s Azure Monitor a Log Analytics. Protokoly aplikací se zaznamenávají jenom v případě, že kontejner zapisuje výstup do stdout nebo stderr, takže se ujistěte, že vaše aplikace odesílá protokoly do konzoly.

Předpoklady

  • Prostředí Azure Container Apps s vlastním fondem relací kontejnerů
  • Pracovní prostor služby Log Analytics nebo vytvoření pracovního prostoru během instalace

Konfigurujte protokolování

Povolení protokolování služby Azure Monitor

  1. Na webu Azure Portal přejděte do prostředí Container Apps.
  2. V části Monitorování vyberte Možnosti protokolování.
  3. Nastavte cíl protokolů na Azure Monitor.

Konfigurace nastavení diagnostiky

  1. V prostředí Container Apps v části Monitorování vyberte Nastavení diagnostiky.
  2. Vyberte + Přidat nastavení diagnostiky.
  3. Zadejte název nastavení diagnostiky.
  4. V části Protokoly vyberte kategorie protokolů související s relacemi, které chcete zaznamenat.
  5. V části Podrobnosti o cíli vyberte Možnost Odeslat do pracovního prostoru služby Log Analytics.
  6. Zvolte pracovní prostor služby Log Analytics nebo vytvořte nový.
  7. Vyberte Uložit.

Tabulky Log Analytics

Kategorie protokolu Tabulka Log Analytics Popis
Záznamy aplikací AppEnvSessionConsoleLogs Standardní výstup (stdout) a standardní chyba (stderr) generované kontejnerizovanou aplikací
Protokoly platformy AppEnvSessionLifecycleLogs, AppEnvSessionPoolEvents Události generované platformou související s přidělováním fondu relací, životním cyklem a provozním stavem.

Pokud se protokoly odesílají přímo do Log Analytics, tabulky používají příponu _CL, například AppEnvSessionConsoleLogs_CL. Pokud se protokoly směrují přes nastavení diagnostiky služby Azure Monitor, názvy tabulek nezahrnují příponu _CL.

Zobrazit protokoly relací

Po nakonfigurování nastavení diagnostiky se protokoly posílají do pracovního prostoru služby Log Analytics.

Protokoly dotazů v Log Analytics

  1. Na webu Azure Portal přejděte do pracovního prostoru služby Log Analytics.
  2. V nabídce vlevo vyberte Protokoly.
  3. Pokud je dotaz v jednoduchém režimu, vyberte režim KQL.
  4. K dotazování protokolů relací použijte dotazovací jazyk Kusto (KQL ).

Příkladové dotazy

Zobrazit nedávné logy konzole z relací:

AppEnvSessionConsoleLogs
| where TimeGenerated > ago(1h)
| order by TimeGenerated desc
| take 100

Zobrazení událostí životního cyklu relace:

AppEnvSessionLifecycleLogs
| where TimeGenerated > ago(1h)
| order by TimeGenerated desc

Zobrazit události fondu relací:

AppEnvSessionPoolEvents
| where TimeGenerated > ago(1h)
| order by TimeGenerated desc

Metrics

Azure Container Apps generuje metriky Azure Monitor pro vlastní skupiny relací kontejnerů. Pomocí těchto metrik můžete sledovat kapacitu fondu a aktivitu v průběhu času.

Podporované metriky

Úplný seznam najdete v tématu Podporované metriky – Microsoft.App/sessionpools – Azure Monitor.

Ukazatel Název v REST API Jednotka Aggregation Dimenze Časová zrnka DS Vývoz
Počet spuštěných relací
Počet běžících podů relací ve fondu relací		 PoolExecutingPodCount Počet Celkem (Součet), Průměr, Maximální, Minimální poolName PT1M Ano
Generování počtu relací
Počet vytvářejících se podů relací ve fondu relací		 PoolPendingPodCount Počet Celkem (Součet), Průměr, Maximální, Minimální poolName PT1M Ano
Počet připravených relací
Počet připravených podů relací ve fondu relací		 PoolReadyPodCount Počet Celkem (Součet), Průměr, Maximální, Minimální poolName PT1M Ano

Zobrazení metrik relací

K zobrazení metrik založených na relacích můžete použít metriky prostředí Azure Monitor nebo Container Apps.

Metriky Azure Monitoru

  1. Otevřete stránku Metriky služby Azure Monitor.
  2. Použijte Scope k výběru vlastního fondu relací kontejneru.
  3. Zvolte metriku a agregaci, která chcete zobrazit.

Metriky prostředí Container Apps

  1. Na webu Azure Portal otevřete prostředí Container Apps.
  2. V oblasti Monitorování vyberte Metriky.
  3. Použijte Scope k výběru vlastního fondu relací kontejneru.
  4. Zvolte metriku a agregaci, která chcete zobrazit.

Související obsah

  • Last updated on