Журналы пограничных Essentials AKS
Если у вас возникают проблемы с запуском AKS Edge Essentials IoT Edge в вашей среде, используйте эту статью в качестве руководства по сбору и использованию журналов.
Получение журналов
При устранении неполадок с AKS Edge Essentials сначала необходимо собрать журналы. Самый удобный способ — использовать Get-AksEdgeLogs
команду . По умолчанию этот командлет собирает различные журналы по управлению виртуальными машинами, сети, службам Kubernetes и т. д. Она сжимает их в единый файл для облегчения совместного использования.
Чтобы получить журналы Essentials AKS Edge, выполните следующие действия.
Откройте сеанс PowerShell с повышенными привилегиями.
Выполните командлет , чтобы получить журналы:
Get-AksEdgeLogs
Все журналы хранятся в файле .zip по следующему пути: C:\ProgramData\AksEdge\logs\aksedge-logs-ddmmyy-hhmm.zip.
Перейдите в папку C:\ProgramData\AksEdge\logs и распакуть файл журналовaksedge-logs-ddmmyy-hhmm.zip .
Общие сведения о журналах
Сжатый файл журнала состоит из различных файлов конфигурации, журналов развертывания и служб, а также сведений об ОС узла и развернутом кластере. В зависимости от состояния кластера, дистрибутива Kubernetes и ОС узла некоторые файлы могут быть недоступны.
Журналы ОС узла Windows
Имя файла | Группа | Описание |
---|---|---|
aksedgeevents.xml | Журнал событий Windows | События Windows, зарегистрированные во время развертывания или жизненного цикла виртуальной машины. Чтобы вручную проверка эти события, используйте приложение Просмотр событий и проверка события в разделе Журналы приложений и служб ->AKS Edge Essentials- K3s/K8s. |
aksedgehost-systeminfo | Сведения | Сведения об ОС узла Windows, включая: версию PowerShell, версию ОС Windows, ЦП, память и хранилище. |
Microsoft-Windows-Host-Network-Service-Admin.xml | Журнал событий Windows | Журнал событий Windows службы HNS — только внутреннее использование. |
Microsoft-Windows-Host-Network-Service-Operational.xml | Журнал событий Windows | Журнал событий Windows операционной службы HNS — только для внутреннего использования. |
Microsoft-Windows-Hyper-V-Compute-Admin.xml | Журнал событий Windows | Здесь собираются события из службы вычислений узла (HCS) — только для внутреннего использования. |
Microsoft-Windows-Hyper-V-Compute-Operational.xml | Журнал событий Windows | Здесь собираются события из службы вычислений узла (HCS) — только для внутреннего использования. |
Microsoft-Windows-Hyper-V-VMMS-Admin.xml | Журнал событий Windows | События из службы управления виртуальными машинами (VMMS) можно найти здесь ( только для внутреннего использования). |
Microsoft-Windows-Hyper-V-VMMS-Networking.xml | Журнал событий Windows | События из сетевого стека службы управления виртуальными машинами (VMMS) можно найти здесь ( только для внутреннего использования). |
Microsoft-Windows-Hyper-V-VMMS-Operational.xml | Журнал событий Windows | События из операции службы управления виртуальными машинами (VMMS) можно найти здесь ( только для внутреннего использования). |
Журналы Wssdagent
WSSDAgent — это служба пограничного Essentials AKS, используемая для создания виртуальных машин и управления жизненным циклом. Эта служба работает в ос узла Windows и использует реализации API Hyper-V (HCS или VMMS) для управления виртуальными машинами.
Имя файла | Группа | Описание |
---|---|---|
agent-log-0 | Сведения о виртуальной машине | Журналы жизненного цикла виртуальных машин — только для внутреннего использования. |
wssdagent | Сведения о виртуальной машине | Журналы жизненного цикла виртуальных машин — только для внутреннего использования. |
Другие файлы | Конфигурация развертывания. | Только для внутреннего использования. |
Журналы контейнеров Linux
Контейнеры Linux, работающие на узлах Linux, используют /var/log/continers/<container-name>.log
файлы для хранения журналов контейнеров. Все эти .log
файлы копируются и сжимаются в папке linux-containers .
Журналы пограничных узлов AKS
Эти журналы должны быть независимыми от типа кластера и используемого дистрибутива Kubernetes (K3s или K8s).
Имя файла | Группа | Описание |
---|---|---|
aksedgeconfig.txt | Конфигурации развертывания | Хранит конфигурацию развертывания, используемую для создания кластера. В этом файле хранятся как внутренние, так и пользовательские конфигурации. |
aksedgelogs-summary | Сведения | Сведения о том, какие журналы были собраны и включены в сжатый файл журналов. |
AksEdgenetworkConfig_LinuxVm | Сведения о виртуальной машине | Выходные данные конфигураций сети: IP-адреса сетевых интерфейсов (sudo ip a ), используемые маршруты (sudo route ) и правила брандмауэра iptables (sudo iptables -L ). |
<Windows-hostname-ledge_cloudinit> и <Windows-hostname-ledge_cloudinit-output> | Сведения о виртуальной машине | Выходные данные конфигурации cloudinit, используемой для создания виртуальной машины Linux. Дополнительные сведения см. в документации по cloudinit. |
<Windows-hostname-ledge_systemd> | Сведения о виртуальной машине | Журналы linux systemd (sudo journalctl ). |
<Windows-hostname-ledge_vmconfig> | Конфигурация развертывания | Конфигурация виртуальной машины Linux — только для внутреннего использования. |
<Windows-hostname-ledge-aksedge-agent> | Сведения о виртуальной машине | Журналы развертывания виртуальных машин Linux — только для внутреннего использования. |
<Windows-hostname-ledge-aksedge-agent-config> | Конфигурация развертывания | Конфигурация виртуальной машины Linux — только для внутреннего использования. |
<Windows-hostname-ledge-aksedge-lifecycle-config> | Конфигурация развертывания | Конфигурация виртуальной машины Linux — только для внутреннего использования. |
<Windows-hostname-wedge_cloudbase-init> и <Windows-hostname-ledge_cloudbase-init-unattend> | Сведения о виртуальной машине | Выходные данные конфигурации cloudinit, используемой для создания виртуальной машины Windows. Дополнительные сведения проверка документации по cloudbase-init. |
<Windows-hostname-wedge_ipconfig> | Сведения о виртуальной машине | Выходные данные конфигурации сети: IP-адреса сетевых интерфейсов (ipconfig /all ). |
<Windows-hostname-wedge_vmconfig> | Конфигурация развертывания | Конфигурации виртуальных машин Windows — только для внутреннего использования. |
<Windows-hostname-wedge-aksedge-agent> | Сведения о виртуальной машине | Журналы развертывания виртуальных машин Windows — только для внутреннего использования. |
<Windows-hostname-wedge-aksedge-agent-config> | Конфигурация развертывания | Конфигурация виртуальной машины Windows — только для внутреннего использования. |
<Windows-hostname-ledge-aksedge-lifecycle-mgmt> | Сведения о виртуальной машине | Журналы управления жизненным циклом виртуальных машин Windows — только для внутреннего использования. |
config | Конфигурация развертывания | Копия конфигурации JSON, используемой для развертывания. Конфиденциальная информация не включается. |
hcsdiag_list | Сведения о виртуальной машине | Запуск виртуальных машин, созданных HCS. Допустимо только для развертываний ОС узла клиента Windows. Пограничные узлы AKS Essentials должны выполняться под именем wssdagent. |
hnsdiag_list_all | Сведения о виртуальной машине | Сведения о сети, связанные с виртуальными машинами. Допустимо только для развертываний ОС узла клиента Windows. |
kubectl_describe | Сведения о Kubernetes | Выходные данные выполнения kubectl describe nodes . Дополнительные сведения об этой команде см. в справочной документации по Kubectl. |
kubectl_pods | Сведения о кластере | Выходные данные выполнения kubectl describe pods . Дополнительные сведения об этой команде см. в справочной документации по Kubectl. |
Журналы, относящиеся к K3s
Эти журналы доступны только в том случае, если установлена версия AKS Edge Essentials K3s и развернуты узлы Linux и (или) Windows.
Имя файла | Группа | Описание |
---|---|---|
<Windows-hostname-ledge_k3s> | Сведения о Kubernetes | Журналы системной службы K3S Linux (sudo journalctl -u k3s или sudo journalctl -u k3s-agent ). |
<Windows-hostname-wedge_k3s> | Сведения о Kubernetes | Журналы системной службы Windows K3S (C:\tmp\K3s.log ). |
<Windows-hostname-wedge_k3s-config> | Сведения о Kubernetes | Файл конфигурации, используемый для добавления узлов Windows K3s. |
Журналы, относящиеся к K8s
Эти журналы доступны только в том случае, если установлена версия AKS Edge Essentials K8s и развернуты узлы Linux и (или) Windows.
Имя файла | Группа | Описание |
---|---|---|
<Windows-hostname-ledge_k8s> | Сведения о Kubernetes | Журналы системной службы K8s Linux (sudo journalctl -u kubelet ). |
<Windows-hostname-wedge_k8s> | Сведения о Kubernetes | Журналы системной службы Windows K8s (C:\tmp\kubelet.log ). |
<Windows-hostname-wedge_k8s-config> | Сведения о Kubernetes | Файл конфигурации, используемый для добавления узла Windows K8s. |