mirror of
https://github.com/rancher/rancher-docs.git
synced 2026-09-29 06:29:34 +00:00
32 lines
41 KiB
HTML
32 lines
41 KiB
HTML
<!doctype html>
|
||
<html lang="en" dir="ltr" class="docs-wrapper docs-doc-page docs-version-current plugin-docs plugin-id-default docs-doc-id-integrations-in-rancher/logging/logging" data-has-hydrated="false">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="generator" content="Docusaurus v2.4.3">
|
||
<title data-rh="true">Rancher Integration with Logging Services | Rancher</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://ranchermanager.docs.rancher.com/integrations-in-rancher/logging"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Rancher Integration with Logging Services | Rancher"><meta data-rh="true" name="description" content="Rancher integrates with popular logging services. Learn the requirements and benefits of integrating with logging services, and enable logging on your cluster."><meta data-rh="true" property="og:description" content="Rancher integrates with popular logging services. Learn the requirements and benefits of integrating with logging services, and enable logging on your cluster."><link data-rh="true" rel="icon" href="/img/favicon.png"><link data-rh="true" rel="alternate" href="https://ranchermanager.docs.rancher.com/integrations-in-rancher/logging" hreflang="en"><link data-rh="true" rel="alternate" href="https://ranchermanager.docs.rancher.com/zh/integrations-in-rancher/logging" hreflang="zh"><link data-rh="true" rel="alternate" href="https://ranchermanager.docs.rancher.com/integrations-in-rancher/logging" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://30NEY6C9UY-dsn.algolia.net" crossorigin="anonymous"><link data-rh="true" rel="canonical" href="https://ranchermanager.docs.rancher.com/integrations-in-rancher/logging"><link rel="preconnect" href="https://www.googletagmanager.com">
|
||
<script>window.dataLayer=window.dataLayer||[]</script>
|
||
<script>!function(e,t,a,n,g){e[n]=e[n]||[],e[n].push({"gtm.start":(new Date).getTime(),event:"gtm.js"});var m=t.getElementsByTagName(a)[0],r=t.createElement(a);r.async=!0,r.src="https://www.googletagmanager.com/gtm.js?id=GTM-57KS2MW",m.parentNode.insertBefore(r,m)}(window,document,"script","dataLayer")</script>
|
||
|
||
|
||
|
||
<link rel="search" type="application/opensearchdescription+xml" title="Rancher" href="/opensearch.xml">
|
||
|
||
|
||
|
||
<script src="https://cdn.cookielaw.org/scripttemplates/otSDKStub.js" charset="UTF-8" data-domain-script="0f98beb0-fc4c-417d-a42e-564e2cae42d2" async></script>
|
||
<script src="/scripts/optanonwrapper.js" async></script><link rel="stylesheet" href="/assets/css/styles.dea80607.css">
|
||
<link rel="preload" href="/assets/js/runtime~main.d98f8a34.js" as="script">
|
||
<link rel="preload" href="/assets/js/main.e9ebdfba.js" as="script">
|
||
</head>
|
||
<body class="navigation-with-keyboard">
|
||
<noscript><iframe src="https://www.googletagmanager.com/ns.html?id=GTM-57KS2MW" height="0" width="0" style="display:none;visibility:hidden"></iframe></noscript>
|
||
|
||
|
||
<script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){var t=null;try{t=new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}return t}()||function(){var t=null;try{t=localStorage.getItem("theme")}catch(t){}return t}();t(null!==e?e:"light")}()</script><div id="__docusaurus">
|
||
<div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/rancher-logo-horiz-color.svg" alt="logo" class="themedImage_ToTc themedImage--light_HNdA"><img src="/img/rancher-logo-horiz-color.svg" alt="logo" class="themedImage_ToTc themedImage--dark_i4oU"></div><b class="navbar__title text--truncate"></b></a><div class="navbar__item dropdown dropdown--hoverable"><a aria-current="page" class="navbar__link active" aria-haspopup="true" aria-expanded="false" role="button" href="/">Latest</a><ul class="dropdown__menu"><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/integrations-in-rancher/logging">Latest</a></li><li><a class="dropdown__link" href="/v2.9/integrations-in-rancher/logging">v2.9 (Preview)</a></li><li><a class="dropdown__link" href="/v2.8/integrations-in-rancher/logging">v2.8</a></li><li><a class="dropdown__link" href="/v2.7/integrations-in-rancher/logging">v2.7</a></li><li><a class="dropdown__link" href="/v2.6/integrations-in-rancher/logging">v2.6</a></li><li><a class="dropdown__link" href="/v2.5">v2.5</a></li><li><a class="dropdown__link" href="/v2.0-v2.4">v2.0-v2.4</a></li><li><a class="dropdown__link" href="/versions">All versions</a></li></ul></div><div class="navbar__item dropdown dropdown--hoverable"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link"><svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" class="iconLanguage_nlXk"><path fill="currentColor" d="M12.87 15.07l-2.54-2.51.03-.03c1.74-1.94 2.98-4.17 3.71-6.53H17V4h-7V2H8v2H1v1.99h11.17C11.5 7.92 10.44 9.75 9 11.35 8.07 10.32 7.3 9.19 6.69 8h-2c.73 1.63 1.73 3.17 2.98 4.56l-5.09 5.02L4 19l5-5 3.11 3.11.76-2.04zM18.5 10h-2L12 22h2l1.12-3h4.75L21 22h2l-4.5-12zm-2.62 7l1.62-4.33L19.12 17h-3.24z"></path></svg>English</a><ul class="dropdown__menu"><li><a href="/integrations-in-rancher/logging" target="_self" rel="noopener noreferrer" class="dropdown__link dropdown__link--active" lang="en">English</a></li><li><a href="/zh/integrations-in-rancher/logging" target="_self" rel="noopener noreferrer" class="dropdown__link" lang="zh">简体中文</a></li></ul></div><div class="searchBox_ZlJk"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div><div class="navbar__items navbar__items--right"><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link">Quick Links</a><ul class="dropdown__menu"><li><a href="https://github.com/rancher/rancher" target="_blank" rel="noopener noreferrer" class="dropdown__link">GitHub<svg width="12" height="12" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li><a href="https://github.com/rancher/rancher-docs" target="_blank" rel="noopener noreferrer" class="dropdown__link">Docs GitHub<svg width="12" height="12" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="navbar__item dropdown dropdown--hoverable dropdown--right"><a href="#" aria-haspopup="true" aria-expanded="false" role="button" class="navbar__link">More from SUSE</a><ul class="dropdown__menu"><li><a href="https://www.rancher.com" target="_blank" rel="noopener noreferrer" class="dropdown__link navbar__icon navbar__rancher">Rancher<svg width="12" height="12" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li><hr style="margin: 0.3rem 0;"></li><li><a href="https://elemental.docs.rancher.com/" target="_blank" rel="noopener noreferrer" class="dropdown__link navbar__icon navbar__elemental">Elemental<svg width="12" height="12" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li><a href="https://fleet.rancher.io/" target="_blank" rel="noopener noreferrer" class="dropdown__link navbar__icon navbar__fleet">Fleet<svg width="12" height="12" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li><a href="https://harvesterhci.io" target="_blank" rel="noopener noreferrer" class="dropdown__link navbar__icon navbar__harvester">Harvester<svg width="12" height="12" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li><a href="https://rancherdesktop.io/" target="_blank" rel="noopener noreferrer" class="dropdown__link navbar__icon navbar__rancher__desktop">Rancher Desktop<svg width="12" height="12" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li><hr style="margin: 0.3rem 0;"></li><li><a href="https://opensource.suse.com" target="_blank" rel="noopener noreferrer" class="dropdown__link navbar__icon navbar__suse">More Projects...<svg width="12" height="12" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_z2l0 docsWrapper_BCFX"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docPage__5DB"><aside class="theme-doc-sidebar-container docSidebarContainer_b6E3"><div class="sidebarViewport_Xe31"><div class="sidebar_njMd"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/">What is Rancher?</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/getting-started/overview">Getting Started</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/how-to-guides/new-user-guides">How-to Guides</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/reference-guides/best-practices">Reference Guides</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--active" aria-expanded="true" href="/integrations-in-rancher">Integrations in Rancher</a><button aria-label="Toggle the collapsible sidebar category 'Integrations in Rancher'" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/integrations-in-rancher/kubernetes-distributions">Kubernetes Distributions</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/integrations-in-rancher/harvester">Virtualization on Kubernetes with Harvester</a><button aria-label="Toggle the collapsible sidebar category 'Virtualization on Kubernetes with Harvester'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/integrations-in-rancher/longhorn">Cloud Native Storage with Longhorn</a><button aria-label="Toggle the collapsible sidebar category 'Cloud Native Storage with Longhorn'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/integrations-in-rancher/neuvector">Container Security with Neuvector</a><button aria-label="Toggle the collapsible sidebar category 'Container Security with Neuvector'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/integrations-in-rancher/kubewarden">Advanced Policy Management with Kubewarden</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/integrations-in-rancher/elemental">Operating System Management with Elemental</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/integrations-in-rancher/fleet">Continuous Delivery with Fleet</a><button aria-label="Toggle the collapsible sidebar category 'Continuous Delivery with Fleet'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/integrations-in-rancher/rancher-desktop">Kubernetes on the Desktop with Rancher Desktop</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/integrations-in-rancher/cloud-marketplace">Cloud Marketplace Integration</a><button aria-label="Toggle the collapsible sidebar category 'Cloud Marketplace Integration'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/integrations-in-rancher/cluster-api">Cluster API (CAPI) with Rancher Turtles</a><button aria-label="Toggle the collapsible sidebar category 'Cluster API (CAPI) with Rancher Turtles'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/integrations-in-rancher/cis-scans">CIS Scans</a><button aria-label="Toggle the collapsible sidebar category 'CIS Scans'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/integrations-in-rancher/istio">Istio</a><button aria-label="Toggle the collapsible sidebar category 'Istio'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item"><div class="menu__list-item-collapsible menu__list-item-collapsible--active"><a class="menu__link menu__link--sublist menu__link--active" aria-current="page" aria-expanded="true" tabindex="0" href="/integrations-in-rancher/logging">Logging</a><button aria-label="Toggle the collapsible sidebar category 'Logging'" type="button" class="clean-btn menu__caret"></button></div><ul style="display:block;overflow:visible;height:auto" class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/integrations-in-rancher/logging/logging-architecture">Logging Architecture</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/integrations-in-rancher/logging/rbac-for-logging">Role-based Access Control for Logging</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/integrations-in-rancher/logging/logging-helm-chart-options">rancher-logging Helm Chart Options</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-3 menu__list-item"><a class="menu__link" tabindex="0" href="/integrations-in-rancher/logging/taints-and-tolerations">Working with Taints and Tolerations</a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-3 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/integrations-in-rancher/logging/custom-resource-configuration">Custom Resource Configuration</a><button aria-label="Toggle the collapsible sidebar category 'Custom Resource Configuration'" type="button" class="clean-btn menu__caret"></button></div></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist" aria-expanded="false" tabindex="0" href="/integrations-in-rancher/monitoring-and-alerting">Monitoring and Alerting</a><button aria-label="Toggle the collapsible sidebar category 'Monitoring and Alerting'" type="button" class="clean-btn menu__caret"></button></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/integrations-in-rancher/opa-gatekeeper">OPA Gatekeeper</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/integrations-in-rancher/rancher-extensions">Rancher Extensions</a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/faq/general-faq">FAQ</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/troubleshooting/general-troubleshooting">Troubleshooting</a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="menu__link menu__link--sublist menu__link--sublist-caret" aria-expanded="false" href="/api/quickstart">Rancher Kubernetes API</a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/contribute-to-rancher">Contributing to Rancher</a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 menu__list-item"><a class="menu__link" href="/glossary">Glossary</a></li></ul></nav></div></div></aside><main class="docMainContainer_gTbr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_VOVn"><div class="docItemContainer_Djhp"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs" itemscope="" itemtype="https://schema.org/BreadcrumbList"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" class="breadcrumbHomeIcon_YNFT"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item"><a class="breadcrumbs__link" itemprop="item" href="/integrations-in-rancher"><span itemprop="name">Integrations in Rancher</span></a><meta itemprop="position" content="1"></li><li itemscope="" itemprop="itemListElement" itemtype="https://schema.org/ListItem" class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link" itemprop="name">Logging</span><meta itemprop="position" content="2"></li></ul></nav><span class="theme-doc-version-badge badge badge--secondary">Version: Latest</span><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Rancher Integration with Logging Services</h1></header><p>The <a href="https://kube-logging.github.io/docs/" target="_blank" rel="noopener noreferrer">Logging operator</a> now powers Rancher's logging solution in place of the former, in-house solution.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="enabling-logging">Enabling Logging<a href="#enabling-logging" class="hash-link" aria-label="Direct link to Enabling Logging" title="Direct link to Enabling Logging"></a></h2><p>You can enable the logging for a Rancher managed cluster by going to the Apps page and installing the logging app.</p><ol><li>Go to the cluster where you want to install logging and click <strong>Apps</strong>.</li><li>Click the <strong>Logging</strong> app.</li><li>Scroll to the bottom of the Helm chart README and click <strong>Install</strong>.</li></ol><p><strong>Result:</strong> The logging app is deployed in the <code>cattle-logging-system</code> namespace.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="uninstall-logging">Uninstall Logging<a href="#uninstall-logging" class="hash-link" aria-label="Direct link to Uninstall Logging" title="Direct link to Uninstall Logging"></a></h2><ol><li>Go to the cluster where you want to install logging and click <strong>Apps</strong>.</li><li>Click <strong>Installed Apps</strong>.</li><li>Go to the <code>cattle-logging-system</code> namespace and check the boxes for <code>rancher-logging</code> and <code>rancher-logging-crd</code>.</li><li>Click <strong>Delete</strong>.</li><li>Confirm <strong>Delete</strong>.</li></ol><p><strong>Result</strong> <code>rancher-logging</code> is uninstalled.</p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="architecture">Architecture<a href="#architecture" class="hash-link" aria-label="Direct link to Architecture" title="Direct link to Architecture"></a></h2><p>For more information about how the logging application works, see <a href="/integrations-in-rancher/logging/logging-architecture">this section.</a></p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="role-based-access-control">Role-based Access Control<a href="#role-based-access-control" class="hash-link" aria-label="Direct link to Role-based Access Control" title="Direct link to Role-based Access Control"></a></h2><p>Rancher logging has two roles, <code>logging-admin</code> and <code>logging-view</code>. For more information on how and when to use these roles, see <a href="/integrations-in-rancher/logging/rbac-for-logging">this page.</a></p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="configuring-logging-custom-resources">Configuring Logging Custom Resources<a href="#configuring-logging-custom-resources" class="hash-link" aria-label="Direct link to Configuring Logging Custom Resources" title="Direct link to Configuring Logging Custom Resources"></a></h2><p>To manage <code>Flows,</code> <code>ClusterFlows</code>, <code>Outputs</code>, and <code>ClusterOutputs</code>,</p><ol><li>In the upper left corner, click <strong>☰ > Cluster Management</strong>.</li><li>On the <strong>Clusters</strong> page, go to the cluster where you want to configure logging custom resources and click <strong>Explore</strong>.</li><li>In the left navigation bar, click <strong>Logging</strong>.</li></ol><h3 class="anchor anchorWithStickyNavbar_LWe7" id="flows-and-clusterflows">Flows and ClusterFlows<a href="#flows-and-clusterflows" class="hash-link" aria-label="Direct link to Flows and ClusterFlows" title="Direct link to Flows and ClusterFlows"></a></h3><p>For help with configuring <code>Flows</code> and <code>ClusterFlows</code>, see <a href="/integrations-in-rancher/logging/custom-resource-configuration/flows-and-clusterflows">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="outputs-and-clusteroutputs">Outputs and ClusterOutputs<a href="#outputs-and-clusteroutputs" class="hash-link" aria-label="Direct link to Outputs and ClusterOutputs" title="Direct link to Outputs and ClusterOutputs"></a></h3><p>For help with configuring <code>Outputs</code> and <code>ClusterOutputs</code>, see <a href="/integrations-in-rancher/logging/custom-resource-configuration/outputs-and-clusteroutputs">this page.</a></p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="configuring-the-logging-helm-chart">Configuring the Logging Helm Chart<a href="#configuring-the-logging-helm-chart" class="hash-link" aria-label="Direct link to Configuring the Logging Helm Chart" title="Direct link to Configuring the Logging Helm Chart"></a></h2><p>For a list of options that can be configured when the logging application is installed or upgraded, see <a href="/integrations-in-rancher/logging/logging-helm-chart-options">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="windows-support">Windows Support<a href="#windows-support" class="hash-link" aria-label="Direct link to Windows Support" title="Direct link to Windows Support"></a></h3><p>You can <a href="/integrations-in-rancher/logging/logging-helm-chart-options#enabledisable-windows-node-logging">enable logging</a> from Windows nodes.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="working-with-a-custom-docker-root-directory">Working with a Custom Docker Root Directory<a href="#working-with-a-custom-docker-root-directory" class="hash-link" aria-label="Direct link to Working with a Custom Docker Root Directory" title="Direct link to Working with a Custom Docker Root Directory"></a></h3><p>For details on using a custom Docker root directory, see <a href="/integrations-in-rancher/logging/logging-helm-chart-options#working-with-a-custom-docker-root-directory">this section.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="working-with-taints-and-tolerations">Working with Taints and Tolerations<a href="#working-with-taints-and-tolerations" class="hash-link" aria-label="Direct link to Working with Taints and Tolerations" title="Direct link to Working with Taints and Tolerations"></a></h3><p>For information on how to use taints and tolerations with the logging application, see <a href="/integrations-in-rancher/logging/taints-and-tolerations">this page.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="logging-v2-with-selinux">Logging V2 with SELinux<a href="#logging-v2-with-selinux" class="hash-link" aria-label="Direct link to Logging V2 with SELinux" title="Direct link to Logging V2 with SELinux"></a></h3><p>For information on enabling the logging application for SELinux-enabled nodes, see <a href="/integrations-in-rancher/logging/logging-helm-chart-options#enabling-the-logging-application-to-work-with-selinux">this section.</a></p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="additional-logging-sources">Additional Logging Sources<a href="#additional-logging-sources" class="hash-link" aria-label="Direct link to Additional Logging Sources" title="Direct link to Additional Logging Sources"></a></h3><p>By default, Rancher collects logs for control plane components and node components for all cluster types. In some cases additional logs can be collected. For details, see <a href="/integrations-in-rancher/logging/logging-helm-chart-options#additional-logging-sources">this section.</a></p><h2 class="anchor anchorWithStickyNavbar_LWe7" id="troubleshooting">Troubleshooting<a href="#troubleshooting" class="hash-link" aria-label="Direct link to Troubleshooting" title="Direct link to Troubleshooting"></a></h2><h3 class="anchor anchorWithStickyNavbar_LWe7" id="the-logging-buffer-overloads-pods">The Logging Buffer Overloads Pods<a href="#the-logging-buffer-overloads-pods" class="hash-link" aria-label="Direct link to The Logging Buffer Overloads Pods" title="Direct link to The Logging Buffer Overloads Pods"></a></h3><p>Depending on your configuration, the default buffer size may be too large and cause pod failures. One way to reduce the load is to lower the logger's flush interval. This prevents logs from overfilling the buffer. You can also add more flush threads to handle moments when many logs are attempting to fill the buffer at once.</p><p>For a more complete description of how to configure the logging buffer to suit your organization's needs, see the official Logging operator documentation on <a href="https://kube-logging.github.io/docs/configuration/plugins/outputs/buffer/" target="_blank" rel="noopener noreferrer">buffers</a> and on <a href="https://kube-logging.github.io/docs/logging-infrastructure/fluentd/" target="_blank" rel="noopener noreferrer">Fluentd configuration</a>.</p><h3 class="anchor anchorWithStickyNavbar_LWe7" id="the-cattle-logging-namespace-being-recreated">The <code>cattle-logging</code> Namespace Being Recreated<a href="#the-cattle-logging-namespace-being-recreated" class="hash-link" aria-label="Direct link to the-cattle-logging-namespace-being-recreated" title="Direct link to the-cattle-logging-namespace-being-recreated"></a></h3><p>If your cluster previously deployed logging from the global view in the legacy Rancher UI, you may encounter an issue where its <code>cattle-logging</code> namespace is continually being recreated.</p><p>The solution is to delete all <code>clusterloggings.management.cattle.io</code> and <code>projectloggings.management.cattle.io</code> custom resources from the cluster specific namespace in the management cluster.
|
||
The existence of these custom resources causes Rancher to create the <code>cattle-logging</code> namespace in the downstream cluster if it does not exist.</p><p>The cluster namespace matches the cluster ID, so we need to find the cluster ID for each cluster.</p><ol><li>In the upper left corner, click <strong>☰ > Cluster Management</strong>.</li><li>On the <strong>Clusters</strong> page, go to the cluster you want to get the ID of and click <strong>Explore</strong>.</li><li>Copy the <code><cluster-id></code> portion from one of the URLs below. The <code><cluster-id></code> portion is the cluster namespace name.</li></ol><div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Cluster Management UI</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">https://</span><span class="token operator" style="color:rgb(137, 221, 255)"><</span><span class="token plain">your-url</span><span class="token operator" style="color:rgb(137, 221, 255)">></span><span class="token plain">/c/</span><span class="token operator" style="color:rgb(137, 221, 255)"><</span><span class="token plain">cluster-id</span><span class="token operator" style="color:rgb(137, 221, 255)">></span><span class="token plain">/</span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain"></span><span class="token comment" style="color:rgb(105, 112, 152);font-style:italic"># Cluster Dashboard</span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">https://</span><span class="token operator" style="color:rgb(137, 221, 255)"><</span><span class="token plain">your-url</span><span class="token operator" style="color:rgb(137, 221, 255)">></span><span class="token plain">/dashboard/c/</span><span class="token operator" style="color:rgb(137, 221, 255)"><</span><span class="token plain">cluster-id</span><span class="token operator" style="color:rgb(137, 221, 255)">></span><span class="token plain">/</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div><p>Now that we have the <code><cluster-id></code> namespace, we can delete the CRs that cause <code>cattle-logging</code> to be continually recreated.
|
||
<em>Warning:</em> ensure that logging, the version installed from the global view in the legacy Rancher UI, is not currently in use.</p><div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#bfc7d5;--prism-background-color:#292d3e"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl delete crd clusterloggings.management.cattle.io -n </span><span class="token operator" style="color:rgb(137, 221, 255)"><</span><span class="token plain">cluster-id</span><span class="token operator" style="color:rgb(137, 221, 255)">></span><span class="token plain"></span><br></span><span class="token-line" style="color:#bfc7d5"><span class="token plain">kubectl delete crd projectloggings.management.cattle.io -n </span><span class="token operator" style="color:rgb(137, 221, 255)"><</span><span class="token plain">cluster-id</span><span class="token operator" style="color:rgb(137, 221, 255)">></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/rancher/rancher-docs/edit/main/docs/integrations-in-rancher/logging/logging.md" target="_blank" rel="noreferrer noopener" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"><span class="theme-last-updated">Last updated<!-- --> on <b><time datetime="2024-01-29T18:07:22.000Z">Jan 29, 2024</time></b></span></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/integrations-in-rancher/istio/configuration-options/project-network-isolation"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Additional Steps for Project Network Isolation</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/integrations-in-rancher/logging/logging-architecture"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Logging Architecture</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#enabling-logging" class="table-of-contents__link toc-highlight">Enabling Logging</a></li><li><a href="#uninstall-logging" class="table-of-contents__link toc-highlight">Uninstall Logging</a></li><li><a href="#architecture" class="table-of-contents__link toc-highlight">Architecture</a></li><li><a href="#role-based-access-control" class="table-of-contents__link toc-highlight">Role-based Access Control</a></li><li><a href="#configuring-logging-custom-resources" class="table-of-contents__link toc-highlight">Configuring Logging Custom Resources</a><ul><li><a href="#flows-and-clusterflows" class="table-of-contents__link toc-highlight">Flows and ClusterFlows</a></li><li><a href="#outputs-and-clusteroutputs" class="table-of-contents__link toc-highlight">Outputs and ClusterOutputs</a></li></ul></li><li><a href="#configuring-the-logging-helm-chart" class="table-of-contents__link toc-highlight">Configuring the Logging Helm Chart</a><ul><li><a href="#windows-support" class="table-of-contents__link toc-highlight">Windows Support</a></li><li><a href="#working-with-a-custom-docker-root-directory" class="table-of-contents__link toc-highlight">Working with a Custom Docker Root Directory</a></li><li><a href="#working-with-taints-and-tolerations" class="table-of-contents__link toc-highlight">Working with Taints and Tolerations</a></li><li><a href="#logging-v2-with-selinux" class="table-of-contents__link toc-highlight">Logging V2 with SELinux</a></li><li><a href="#additional-logging-sources" class="table-of-contents__link toc-highlight">Additional Logging Sources</a></li></ul></li><li><a href="#troubleshooting" class="table-of-contents__link toc-highlight">Troubleshooting</a><ul><li><a href="#the-logging-buffer-overloads-pods" class="table-of-contents__link toc-highlight">The Logging Buffer Overloads Pods</a></li><li><a href="#the-cattle-logging-namespace-being-recreated" class="table-of-contents__link toc-highlight">The <code>cattle-logging</code> Namespace Being Recreated</a></li></ul></li></ul></div></div></div></div></main></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 SUSE Rancher. All Rights Reserved.</div></div></div></footer></div>
|
||
<script src="/assets/js/runtime~main.d98f8a34.js"></script>
|
||
<script src="/assets/js/main.e9ebdfba.js"></script>
|
||
</body>
|
||
</html> |