LokiStack/homepage/dist/docs/analysis/index.html

<!doctype html>
<html lang="zh-CN"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>日志分析 · LokiStack 文档</title>
<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 64 64'%3E%3Crect width='64' height='64' rx='14' fill='%23059669'/%3E%3Ctext x='32' y='44' font-size='34' font-weight='800' fill='%23fff' text-anchor='middle' font-family='sans-serif'%3EL%3C/text%3E%3C/svg%3E">
<link rel="stylesheet" href="/docs/assets/loki-docs.css">
<style id="h5-fix">@media (max-width:820px){body{-webkit-text-size-adjust:100%}nav a,nav button,.nav-links a,.nav-menu a,.nav-item,.topnav a,.menu a,.side a,.sidebar a,.docs-side a,.toc a,footer a,a.btn,.plan .btn,button.btn{display:inline-flex;align-items:center;min-height:44px}.side a,.sidebar a,.docs-side a{padding:10px 12px;border-radius:8px}.toc a{padding:8px 0}pre{max-width:100%;overflow-x:auto}.plans,.grid,.grid-2,.grid-3{grid-template-columns:1fr!important}.hero h1,.hero-title{font-size:clamp(24px,7vw,34px)!important}.tbl-scroll{max-width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}}</style>
<script id="h5-fix-js">(function(){var f=function(){document.querySelectorAll("table").forEach(function(t){var p=t.parentElement;if(p&&p.classList&&p.classList.contains("tbl-scroll"))return;var w=document.createElement("div");w.className="tbl-scroll";p.insertBefore(w,t);w.appendChild(t);});};if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",f);else f();})();</script>
</head><body>
<div class="topbar">
  <a class="brand" href="/"><i>L</i>LokiStack</a>
  <span style="color:#98a2b3;font-size:13px">文档</span>
  <nav class="topnav"><a href="/">官网</a><a href="/docs/" class="on">文档</a></nav>
</div>
<div class="layout">
  <aside class="side"><h4>开始使用</h4><a data-slug="readme" href="/docs/readme/">产品介绍</a><a data-slug="install" href="/docs/install/">快速安装</a><a data-slug="wizard" href="/docs/wizard/">部署向导</a><h4>采集与查询</h4><a data-slug="collectors" href="/docs/collectors/">日志采集</a><a data-slug="query" href="/docs/query/">日志查询</a><a data-slug="analysis" href="/docs/analysis/" class="on">日志分析</a><a data-slug="access" href="/docs/access/">查询授权</a><h4>告警与运维</h4><a data-slug="alerts" href="/docs/alerts/">告警通知</a><a data-slug="faq" href="/docs/faq/">常见问题</a></aside>
  <article>
    <h1>日志分析</h1>
    <div class="meta">采集与查询 · 更新于 2026-10-28</div>
    <p>「日志分析」页(<code>/analysis</code>,管理员)自动聚合日志指标,无需手动查询:</p>
<p><img alt="日志分析" src="/docs/assets/screenshots/analysis.png" /></p>
<ul>
<li><strong>统计卡</strong>:日志总量、日志体积、错误行数、活跃应用</li>
<li><strong>趋势折线</strong>:按时间分桶的日志体积(≤12 小时 15 分钟一桶,&gt;12 小时 1 小时一桶)</li>
<li><strong>应用排行</strong>:按<strong>日志体积</strong>排 Top 10,支持 10/30/50 与前端分页,点击「查看日志」跳转查询页</li>
<li><strong>每日日志量</strong>:平台留存历史,支持 7 / 30 / 90 / 365 天切换(独立于上方时间范围)</li>
<li><strong>Ingress 访问分析</strong>:自动识别 ingress-nginx 访问日志,PV/UV、状态码、慢请求与接口排行;未安装 ingress-nginx 时自动折叠</li>
</ul>
<h2 id="_1">数据来源与耗时</h2>
<table>
<thead>
<tr>
<th>数据</th>
<th>来源</th>
<th>耗时</th>
</tr>
</thead>
<tbody>
<tr>
<td>总量/体积趋势、总条数</td>
<td>Loki 索引接口(<code>index/volume_range</code>、<code>index/stats</code>),只读 chunk 元数据</td>
<td>百毫秒级</td>
</tr>
<tr>
<td>≤1 小时范围的应用排行</td>
<td>实时扫描日志内容(<code>count_over_time</code>)</td>
<td>5 分钟窗口约 5~10 秒</td>
</tr>
<tr>
<td>&gt;1 小时范围的应用排行</td>
<td>平台<strong>按小时预聚合快照</strong>(每小时第 5 分钟抓上一个完整小时)</td>
<td>毫秒级</td>
</tr>
</tbody>
</table>
<blockquote>
<p>一次分析页要跑多条按应用的重查询,因此筛选栏改条件后<strong>点「刷新」才生效</strong>;<br />
应用排行卡片滚动到可视区才发起重查询,避免首屏一起等。</p>
</blockquote>
<h2 id="_2">应用排行的「体积」口径</h2>
<p>预聚合快照对每个应用每小时同时留存 <strong>条数 + 体积</strong>:</p>
<ul>
<li>条数走 <code>count_over_time</code>(要解码日志内容,一小时代价高,每小时后台跑一次)</li>
<li>体积走 <code>index/volume</code>(Loki 索引接口,一个应用约 80ms,所以长范围排行也能按体积排序)</li>
</ul>
<p>体积优先排序的原因:条数会被高频短日志主导(一条 INFO 刷屏 vs 一条大 JSON),<br />
用户真正关心的是「哪个应用把日志量吃掉了」。</p>
<p>体积列上线前抓的小时只有条数,页面会在表格下方提示<br />
「其中 N/M 小时有体积数据…」——<strong>不要把这个提示当成故障</strong>,<br />
它是在说明这段时间的体积偏小是采样口径问题,而不是应用体积真的小。</p>
<h2 id="_3">每日日志量的「未留存」</h2>
<p>每日量来自平台自己的留存库(默认保留 400 天),不受 Loki retention(72 小时)限制。</p>
<ul>
<li><strong>今天的柱子</strong>是「进行中」,每 30 分钟刷新一次;零点后 1 分钟结算前一天</li>
<li><strong>灰色柱 = 平台没有留存记录</strong>(平台当天没运行 / 超出留存期),<strong>不是「当天没有日志」</strong></li>
<li>如果缺失的天画成 0,30/90 天视角会出现大片空柱,容易被误读成「以前日志量很低」甚至「系统停摆过」</li>
</ul>
<p>时间范围与数据源在页面顶部切换;指标查询经服务端聚合,开销远低于拉取原始日志。</p>
    <div class="pager"><a href="/docs/query/">← 日志查询</a><a href="/docs/access/">查询授权 →</a></div>
  </article>
  <nav class="toc"><b>本页目录</b><a href="#_1">数据来源与耗时</a><a href="#_2">应用排行的「体积」口径</a><a href="#_3">每日日志量的「未留存」</a></nav>
</div>
<footer>LokiStack · <a href="/">返回官网</a> · <a href="/pricing">许可和定价</a> · © 日理万机 · <a href="https://beian.miit.gov.cn/" target="_blank" rel="noopener">浙ICP备2026068677号</a></footer>
</body></html>