Екінші буындағы кластерлерде Cloud Logging (logaas-integration) үшін Fluent Bit

1. Аддонды орнату үшін жеткілікті ресурстарыңыз бар екеніне көз жеткізу мақсатында оның жүйелік талаптарымен танысыңыз.

2. (Қосымша) worker-түйіндер топтарын қолмен масштабтауды орындаңыз немесе автоматты масштабтауды баптаңыз.

3. Жобада Cloud Logging сервисін қосыңыз, егер бұл әлі жасалмаған болса. Ол үшін техникалық қолдау қызметіне хабарласыңыз.

4. Құрыңыз Cloud Logging сервисіне логтарды жазу құқықтары бар сервистік есептік жазбаны (СЕЖ). Бұл құқықтар қолжетімді болатын рөлдер Cloud Logging сервисіндегі құқықтар бөліміндегі Сервистік пайдаланушыларды және сервистер атауларын жасау бағанында көрсетілген. Осы СЕЖ үшін ұсынылатын рөл — Аудитор Kubernetes.

   Аддонды орнату кезінде СЕЖ-ге қол жеткізу үшін оның құрылғаннан кейін алынған логині мен паролін пайдаланыңыз.

Аддон үшін тек VK Cloud жеке кабинеті арқылы стандартты орнату нұсқасы қолжетімді.

Аддон кластердің барлық тораптарына, соның ішінде master-тораптарға DaemonSet контроллері түрінде орнатылады.

1. Аддонды орнатыңыз:

   Жеке кабинет

   1. Өтіңіз VK Cloud жеке кабинетіне.

   2. Қажетті кластер орналасқан жобаны таңдаңыз.

   3. Контейнерлер → Кластерлер Kubernetes бөліміне өтіңіз.

   4. Қажетті кластердің атауын басыңыз.

   5. Аддондар қойындысына өтіңіз.

   6. Егер кластерде орнатылған аддондар бұрыннан бар болса, Аддон қосу түймесін басыңыз.

   7. logaas-integration аддонының карточкасындағы Орнату түймесін басыңыз.

   8. Ашылмалы тізімнен аддонның қажетті нұсқасын таңдап, Аддонды орнату түймесін басыңыз.

   9. Қажет болса, мыналарды өңдеңіз:

      • таңдалған нұсқаны;
      • қолданба атауын;
      • аддон орнатылатын атаулар кеңістігінің атауын.

   10. Жасалған СЕЖ-дің логині мен паролін аддонды баптау кодының credentials блогына қосыңыз:

        
       credentials:  username: "<ЛОГИН_СУЗ>"  password: "<ПАРОЛЬ_СУЗ>"  secretName: "logaas-credentials"

   11. Қажет болса, аддонды баптау кодына қосымша өзгерістер енгізіңіз.

   12. Аддонды орнату түймесін басыңыз.

       Аддонды кластерге орнату басталады. Бұл процесс ұзақ уақыт алуы мүмкін.

2. (Опционалды түрде) аддонның жұмысқа қабілетті екеніне көз жеткізу үшін Cloud Logging сервисінде логтарды қараңыз.

Аддон кодын өңдеу стандартты орнатуға қолданылады.

Өрістердің сипаттамасымен бірге аддонды баптаудың толық коды мына жерде қолжетімді:

• жеке кабинетте;
• егер Terraform пайдаланылса, vkcs_kubernetes_addon деректер көзіндегі configuration_values атрибутында.

Сондай-ақ GitHub сайтында осы аддонның негізі болып табылатын Fluent Bit баптау коды қолжетімді.

pipeline пайплайны және конфигурация файлының баптаулары туралы толығырақ Fluent Bit ресми құжаттамасынан оқыңыз.

Логтарды Cloud Logging сервисіне жіберер алдында аддон келесі әрекеттерді орындайды:

1. Логтардағы жекелеген жазбалардың критикалық деңгейін (severity level) анықтайды. Бұл Fluent Bit парсерлері (parsers) арқылы жасалады.

   Қолдау көрсетілетін деңгейлер кестесі

2. Логтарға қосымша метадеректерді қосады, бұл Cloud Containers кластерлерінің логтарымен жұмысты жеңілдетеді (мысалы, Cloud Logging ішінде қажетті логтарды іздеуді). Ол үшін Lua тілінде жазылған арнайы Fluent Bit сүзгілері (filters) қолданылады. Бұл метадеректер, соның ішінде, журналға жазылатын оқиғалардың критикалық деңгейін қамтиды.

   Логтар көзін анықтауға арналған метадеректер туралы толығырақ
   Логтар туралы қосымша ақпараты бар басқа метадеректер туралы толығырақ

Критикалық деңгейлермен жұмыс істеу кезінде аддонның мінез-құлқын дәл баптауды келесілерді пайдаланып орындай аласыз:

 
customFilter:  - namespace: <атаулар кеңістігінің атауы>    rules: # Атаулар кеңістігі үшін бір ереже      - min_level: <ең төменгі критикалық деңгейдің әріптік белгіленуі>  - namespace: <басқа атаулар кеңістігінің атауы>    rules: # Атаулар кеңістігіндегі подтар үшін бірнеше ереже      - podprefix: <под атауының префиксі>        min_level: <ең төменгі критикалық деңгейдің әріптік белгіленуі>      - podprefix: <басқа под атауының префиксі>        min_level: <ең төменгі критикалық деңгейдің әріптік белгіленуі>  - namespace: <басқа атаулар кеңістігінің атауы>    rules: # Атаулар кеңістігіне арналған ереже мен подтарға арналған ережелердің комбинациясы      - min_level: <ең төменгі критикалық деңгейдің әріптік белгіленуі>      - podprefix: <под атауының префиксі>        min_level: <ең төменгі критикалық деңгейдің әріптік белгіленуі>      - podprefix: <под атауының префиксі>        min_level: <ең төменгі критикалық деңгейдің әріптік белгіленуі>

 
customRegexp:  - namespace: <атаулар кеңістігінің атауы>    rules:    - levels: # Атаулар кеңістігі үшін бір ереже: бірнеше деңгейді баптау      - level: <қажетті критикалық деңгейдің әріптік белгіленуі>        reg_exp: "<Lua үлгісі>"      - level: <басқа қажетті критикалық деңгейдің әріптік белгіленуі>        reg_exp: "<Lua үлгісі>"  - namespace: <басқа атаулар кеңістігінің атауы>    rules: # Атаулар кеңістігіндегі подтар үшін бірнеше ереже: бірнеше деңгейді баптау    - podprefix: <под атауының префиксі> # Подтар үшін бірінші ереже      levels:      - level: <қажетті критикалық деңгейдің әріптік белгіленуі>        reg_exp: "<Lua үлгісі>"      - level: <басқа қажетті критикалық деңгейдің әріптік белгіленуі>        reg_exp: "<Lua үлгісі>"    - podprefix: <басқа под атауының префиксі> # Подтар үшін екінші ереже      levels:      - level: <қажетті критикалық деңгейдің әріптік белгіленуі>        reg_exp: "<Lua үлгісі>"  - namespace: <басқа атаулар кеңістігінің атауы>    rules:    - levels: # Атаулар кеңістігі үшін бірінші ереже: бірнеше деңгейді баптау      - level: <қажетті критикалық деңгейдің әріптік белгіленуі>        reg_exp: "<Lua үлгісі>"      - level: <басқа қажетті критикалық деңгейдің әріптік белгіленуі>        reg_exp: "<Lua үлгісі>"    - podprefix: <под атауының префиксі> # Подтар үшін екінші ереже: бірнеше деңгейді баптау      levels:      - level: <қажетті критикалық деңгейдің әріптік белгіленуі>        reg_exp: "<Lua үлгісі>"      - level: <басқа қажетті критикалық деңгейдің әріптік белгіленуі>        reg_exp: "<Lua үлгісі>"