<?xml version="1.0" encoding="utf-8"?>
<?xml-stylesheet href="https://blog.kali-team.cn/feed_style.xsl" type="text/xsl"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
    <tabi:metadata xmlns:tabi="https://github.com/welpo/tabi">
        <tabi:base_url>https://blog.kali-team.cn</tabi:base_url>
        <tabi:separator>
            •
        </tabi:separator>
        <tabi:about_feeds>
            这是Web Feed，又称为Atom Feed，把现在的网址复制到新闻阅读器即可订阅本站文章。造访「About Feeds」来了解更多资讯。
        </tabi:about_feeds>
        <tabi:visit_the_site>
            造访网站
        </tabi:visit_the_site>
        <tabi:recent_posts>
            近期文章
        </tabi:recent_posts>
        <tabi:last_updated_on>
            更新于 $DATE
        </tabi:last_updated_on>
        <tabi:default_theme></tabi:default_theme>
        <tabi:post_listing_date>date</tabi:post_listing_date>
        <tabi:current_section>logging</tabi:current_section>
    </tabi:metadata><link rel="extra-stylesheet" href="https://blog.kali-team.cn/skins/arch.css?h=8b651815fde702215b07" /><title>Kali-Team - logging</title>
        <subtitle>三米前有蕉皮的博客</subtitle>
    <link href="https://blog.kali-team.cn/tags/logging/atom.xml" rel="self" type="application/atom+xml"/>
    <link href="https://blog.kali-team.cn/tags/logging/" rel="alternate" type="text/html"/>
    <generator uri="https://www.getzola.org/">Zola</generator><updated>2026-09-23T00:00:00+00:00</updated><id>https://blog.kali-team.cn/tags/logging/atom.xml</id><entry xml:lang="en">
        <title>安全开发-Grafana与Loki</title>
        <published>2026-09-23T00:00:00+00:00</published>
        <updated>2026-09-23T00:00:00+00:00</updated>
        <author>
            <name>三米前有蕉皮</name>
        </author>
        <link rel="alternate" href="https://blog.kali-team.cn/blog/2026/09/安全开发-Grafana与Loki/" type="text/html"/>
        <id>https://blog.kali-team.cn/blog/2026/09/安全开发-Grafana与Loki/</id>
        
            <content type="html">&lt;h2 id=&quot;1-yin-yan-wei-shen-me-xu-yao-ji-zhong-shi-ri-zhi-shou-ji&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#1-yin-yan-wei-shen-me-xu-yao-ji-zhong-shi-ri-zhi-shou-ji&quot; aria-label=&quot;Anchor link for: 1-yin-yan-wei-shen-me-xu-yao-ji-zhong-shi-ri-zhi-shou-ji&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
1 引言：为什么需要集中式日志收集&lt;/h2&gt;
&lt;p&gt;Gitea、Harbor、SonarQube、Dependency-Track、Gatus 就位之后，甚至“服务活着没“也有状态页在盯。但还有一块看不见：&lt;strong&gt;服务活着的时候，里面发生了什么？&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;现在要看一个服务的日志，标准姿势是 &lt;code&gt;docker logs &amp;lt;容器&amp;gt;&lt;/code&gt; 或 &lt;code&gt;kubectl logs &amp;lt;Pod&amp;gt;&lt;/code&gt;。这对“瞄一眼“够用，但真要排查问题时，它的三个局限很快就顶到脸上：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;要先知道容器在哪台机&lt;/strong&gt;：容器/日志都在具体那台机器的本地。多机部署时，得先查“这个服务跑在哪“，再登到对应机器上敲命令，排查的起点就卡在“找位置“；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;容器删了日志就丢&lt;/strong&gt;：Docker 的日志默认写在本地的 json-file 文件里，容器或 Pod 一删，日志往往跟着删，事后想追“它挂之前最后说了什么“，已经晚了；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;跨机器没法一起查&lt;/strong&gt;：同一个服务的日志散在多台机器上，想问“最近一小时整个服务一共报了多少错“，得一台一台 grep，再人肉汇总。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;集中式日志系统解决的正是这三件事：每台机器上装一个&lt;strong&gt;收集器&lt;/strong&gt;，把本机日志持续送到一个&lt;strong&gt;中心存储&lt;/strong&gt;；查询时只面对一个&lt;strong&gt;统一入口&lt;/strong&gt;，跨机器、跨时间一起搜；再配一个&lt;strong&gt;可视化界面&lt;/strong&gt;，把日志量、错误分布画成图，“哪里不对“一眼可见。&lt;/p&gt;
&lt;p&gt;本文的主角就是这条链路的后半段：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Loki&lt;/strong&gt;，Grafana Labs 出品的开源日志系统。一句话定位：&lt;strong&gt;“只索引标签，不索引正文”&lt;/strong&gt;。传统日志系统会把正文里&lt;strong&gt;每个词&lt;/strong&gt;都建成索引，查得全，但索引巨大、内存磁盘都贵；Loki 只给每条日志流建一小撮标签的索引，标签记的就是“这批日志来自哪个服务、哪个容器“这类信息；正文本身按&lt;strong&gt;压缩块&lt;/strong&gt;存起来，索引小、存储便宜、查询快：先按标签定位到日志流，再在时间范围内扫正文。代价是全文关键词搜索不如 Elasticsearch 灵活，按行过滤是逐行扫描而不是查索引。本环境的服务规模完全够用，而且它和 Grafana 同源，集成最省事；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Grafana&lt;/strong&gt;，开源可视化平台，是统一的查询与可视化入口，Loki 是它原生支持的数据源，配好就能开查。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;2-ding-wei-yu-zheng-ti-jia-gou&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#2-ding-wei-yu-zheng-ti-jia-gou&quot; aria-label=&quot;Anchor link for: 2-ding-wei-yu-zheng-ti-jia-gou&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
2 定位与整体架构&lt;/h2&gt;
&lt;h3 id=&quot;2-1-guan-ce-de-liang-ceng-fen-gong&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#2-1-guan-ce-de-liang-ceng-fen-gong&quot; aria-label=&quot;Anchor link for: 2-1-guan-ce-de-liang-ceng-fen-gong&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
2.1 观测的两层分工&lt;/h3&gt;
&lt;p&gt;内网体系的“观测“分两层，两层分工不同：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;“活没活“层&lt;/strong&gt;：Gatus 周期性探测各端点，状态页红绿展示。它回答的是“哪个服务出事了，该去哪儿看”；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;“发生了什么“层&lt;/strong&gt;：就是本篇的 Grafana + Loki。服务跑起来之后，里面发生的每一件事，不管是处理了什么请求、报了什么错还是做了什么升级动作，都留了痕。它回答的是“到了那儿，接下来看什么”。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;两层合起来才是观测闭环。&lt;/p&gt;
&lt;h3 id=&quot;2-2-zheng-ti-jia-gou-yi-tiao-ri-zhi-de-lv-cheng&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#2-2-zheng-ti-jia-gou-yi-tiao-ri-zhi-de-lv-cheng&quot; aria-label=&quot;Anchor link for: 2-2-zheng-ti-jia-gou-yi-tiao-ri-zhi-de-lv-cheng&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
2.2 整体架构：一条日志的旅程&lt;/h3&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;mermaid&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-9&quot;&gt;flowchart&lt;/span&gt;&lt;span class=&quot;z-3 z-i&quot;&gt; LR&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-9&quot;&gt;    subgraph&lt;/span&gt;&lt;span class=&quot;z-3 z-i&quot;&gt; 收集侧&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;        A&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;Docker 容器&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;] --&amp;gt;|&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;stdout/stderr&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;|&lt;/span&gt;&lt;span&gt; B&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;loki&lt;/span&gt;&lt;span&gt;-&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;docker&lt;/span&gt;&lt;span&gt;-&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;driver&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-9&quot;&gt;    end&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-9&quot;&gt;    subgraph&lt;/span&gt;&lt;span&gt; k3s&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;&amp;quot;k3s 集群内部&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;        C&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;Loki&amp;lt;br/&amp;gt;chart 19.1.1 / 应用 3.7.9&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;        D&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;MinIO 对象存储&amp;lt;br/&amp;gt;+ 持久化&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;        C &lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;---&lt;/span&gt;&lt;span&gt; D&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-9&quot;&gt;    end&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-9&quot;&gt;    subgraph&lt;/span&gt;&lt;span class=&quot;z-3 z-i&quot;&gt; 入口&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;        E&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;[&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;Grafana&amp;lt;br/&amp;gt;grafana.kali&lt;/span&gt;&lt;span&gt;-&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;team.internal&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-9&quot;&gt;    end&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;    B &lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;--&amp;gt;|&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;推送&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;|&lt;/span&gt;&lt;span&gt; C&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;    E &lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;--&amp;gt;|&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;LogQL 查询&lt;/span&gt;&lt;span class=&quot;z-9&quot;&gt;|&lt;/span&gt;&lt;span&gt; C&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Loki 只在集群内可达，不对外暴露。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;收集侧&lt;/strong&gt;：每台跑业务容器的机器上，给 Docker 装一个 Loki 日志驱动，接法在后面“接入新服务“一节细讲。Docker 守护进程收到容器的 stdout/stderr 后，顺手交给这个驱动，驱动批量推给 Loki，&lt;strong&gt;应用本身完全无感&lt;/strong&gt;；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;存储侧&lt;/strong&gt;：Loki 跑在 k3s 集群里，chart 19.1.1、应用 3.7.9，配 MinIO 对象存储做后端、PVC 做持久化；只在集群内可达，不对外暴露；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;入口侧&lt;/strong&gt;：Grafana 通过数据源连 Loki，域名是 grafana.kali-team.internal，在 Explore / 仪表盘里用 LogQL 查询、把结果画出来。&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&quot;3-da-jian-grafana&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-da-jian-grafana&quot; aria-label=&quot;Anchor link for: 3-da-jian-grafana&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3 搭建 Grafana&lt;/h2&gt;
&lt;h3 id=&quot;3-1-zong-ti-si-lu&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-1-zong-ti-si-lu&quot; aria-label=&quot;Anchor link for: 3-1-zong-ti-si-lu&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3.1 总体思路&lt;/h3&gt;
&lt;p&gt;这次部署的四个要点：&lt;/p&gt;
&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;项&lt;/th&gt;&lt;th&gt;选择&lt;/th&gt;&lt;th&gt;说明&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;
&lt;tr&gt;&lt;td&gt;部署方式&lt;/td&gt;&lt;td&gt;Helm chart，chart 14.0.1&lt;/td&gt;&lt;td&gt;仓库用 grafana-community，先登记 chart 仓库，再从目录里挑&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;命名空间&lt;/td&gt;&lt;td&gt;&lt;code&gt;grafana&lt;/code&gt;&lt;/td&gt;&lt;td&gt;独立命名空间，与其他平台隔离&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;Ingress&lt;/td&gt;&lt;td&gt;Traefik + 内网 CA 证书&lt;/td&gt;&lt;td&gt;域名 grafana.kali-team.internal，证书由内网证书体系统一签发&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;存储&lt;/td&gt;&lt;td&gt;开启 PVC 持久化&lt;/td&gt;&lt;td&gt;仪表盘、用户等数据重建不丢&lt;/td&gt;&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;chart 仓库是 grafana-community，地址 &lt;code&gt;https://grafana-community.github.io/helm-charts&lt;/code&gt;。先把仓库加进集群的 Chart 仓库并更新，再从目录里创建应用。Rancher UI 里 grafana chart 的页面如下，版本列表里本文用 14.0.1，对应应用版本 13.2.4：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/01-rancher-grafana-chart.png&quot; alt=&quot;Rancher 里的 grafana chart 页面&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 1：Rancher UI 里的 grafana chart 页面&lt;/em&gt;&lt;/p&gt;
&lt;h3 id=&quot;3-2-values-liang-chu-xiu-gai-zhu-xiang-jiang&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-2-values-liang-chu-xiu-gai-zhu-xiang-jiang&quot; aria-label=&quot;Anchor link for: 3-2-values-liang-chu-xiu-gai-zhu-xiang-jiang&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3.2 values 两处修改逐项讲&lt;/h3&gt;
&lt;p&gt;创建应用时，默认的 values 需要改两处。下面是 diff，只引用改动的两段：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;diff&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; -195,10 +195,10&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   tolerations: []&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; ingress:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   annotations: {}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  enabled: false&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  enabled: true&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   extraPaths: []&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   hosts:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;    - chart-example.local&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    - grafana.kali-team.internal&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   labels: {}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   path: /&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   pathType: Prefix&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; -262,7 +262,7&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   accessModes:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;     - ReadWriteOnce&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   disableWarning: false&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  enabled: false&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  enabled: true&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   extraPvcLabels: {}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   finalizers:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;     - kubernetes.io/pvc-protection&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;h3 id=&quot;3-3-an-zhuang-yu-huo-qu-chu-shi-mi-ma&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-3-an-zhuang-yu-huo-qu-chu-shi-mi-ma&quot; aria-label=&quot;Anchor link for: 3-3-an-zhuang-yu-huo-qu-chu-shi-mi-ma&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3.3 安装与获取初始密码&lt;/h3&gt;
&lt;p&gt;实际安装命令与输出：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;helm&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; install --labels=catalog.cattle.io/cluster-repo-name=grafana --namespace=grafana --timeout=10m0s --values=/home/shell/helm/values-grafana-14.0.1.yaml --version=14.0.1 --wait=true grafana /home/shell/helm/grafana-14.0.1.tgz&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;level&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;=&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;WARN&lt;/span&gt;&lt;span&gt; msg&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;=&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;&amp;quot;--wait=true is deprecated (boolean value) and can be replaced with --wait=watcher&amp;quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;NAME:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; grafana&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;LAST&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; DEPLOYED: Fri Oct&lt;/span&gt;&lt;span class=&quot;z-14&quot;&gt; 23&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; 03:17:35&lt;/span&gt;&lt;span class=&quot;z-14&quot;&gt; 2026&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;NAMESPACE:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; grafana&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;STATUS:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; deployed&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;REVISION:&lt;/span&gt;&lt;span class=&quot;z-14&quot;&gt; 1&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;DESCRIPTION:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; Install complete&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;NOTES:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;1.&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; Get your &amp;#39;admin&amp;#39; user password by running:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;   kubectl&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; get secret --namespace grafana grafana -o jsonpath=&amp;quot;{.data.admin-password}&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt; |&lt;/span&gt;&lt;span class=&quot;z-3 z-i&quot;&gt; base64&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; --decode&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; ;&lt;/span&gt;&lt;span class=&quot;z-11 z-i&quot;&gt; echo&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;2.&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; The Grafana server can be accessed via port&lt;/span&gt;&lt;span class=&quot;z-14&quot;&gt; 80&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; on the following DNS name from within the cluster:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;   grafana.grafana.svc.cluster.local&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;   If&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; you configure Grafana itself to listen on port 80, grant the container&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;   the&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt; `&lt;/span&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;NET_BIND_SERVICE&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;`&lt;/span&gt;&lt;span class=&quot;z-3 z-i&quot;&gt; capability&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; in values.yaml and reinstall:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-1&quot;&gt;   ```&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;   containerSecurityContext:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;     capabilities:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;       add:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;         -&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; NET_BIND_SERVICE&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-1&quot;&gt;   ```&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;   For&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; details, see https://grafana.com/docs/grafana/latest/setup-grafana/configure-grafana/#http_port.&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;   From&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; outside the cluster, the server URL&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;(&lt;/span&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;s&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;)&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; are:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;     http://grafana.kali-team.internal&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;3.&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; Login with the password from step&lt;/span&gt;&lt;span class=&quot;z-14&quot;&gt; 1&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; and the username: admin&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;---------------------------------------------------------------------&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;SUCCESS:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; helm install --labels=catalog.cattle.io/cluster-repo-name=grafana --namespace=grafana --timeout=10m0s --values=/home/shell/helm/values-grafana-14.0.1.yaml --version=14.0.1 --wait=true grafana /home/shell/helm/grafana-14.0.1.tgz&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;输出里有三处值得停一下：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;第 1 条就是获取 admin 初始密码的方法&lt;/strong&gt;：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;kubectl&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; get secret --namespace grafana grafana -o jsonpath=&amp;quot;{.data.admin-password}&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt; |&lt;/span&gt;&lt;span class=&quot;z-3 z-i&quot;&gt; base64&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; --decode&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; ;&lt;/span&gt;&lt;span class=&quot;z-11 z-i&quot;&gt; echo&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;安全约定，很重要&lt;/strong&gt;：&lt;strong&gt;首登后立即修改初始密码&lt;/strong&gt;。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;第 2 条&lt;/strong&gt;：服务地址说明。集群内的 DNS 名是 &lt;code&gt;grafana.grafana.svc.cluster.local&lt;/code&gt;，集群外的 URL 是 &lt;code&gt;http://grafana.kali-team.internal&lt;/code&gt;。chart 默认文案写的是 http；本环境 TLS 由 Traefik 网关终结，浏览器实际走的是 https。这正是下一节 grafana.ini 加固里 &lt;code&gt;root_url&lt;/code&gt; 要设成 https 的原因；&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;第 3 条&lt;/strong&gt;：用 &lt;code&gt;admin&lt;/code&gt; + 第 1 条取到的密码登录。&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;初始密码在 Rancher UI 里也能看到（图 3）。&lt;/p&gt;
&lt;h3 id=&quot;3-4-shou-ci-deng-lu-jie-mian-gai-zhong-wen-jian-kang-jian-cha&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#3-4-shou-ci-deng-lu-jie-mian-gai-zhong-wen-jian-kang-jian-cha&quot; aria-label=&quot;Anchor link for: 3-4-shou-ci-deng-lu-jie-mian-gai-zhong-wen-jian-kang-jian-cha&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
3.4 首次登录 + 界面改中文 + 健康检查&lt;/h3&gt;
&lt;p&gt;浏览器打开 https://grafana.kali-team.internal。本机 /etc/hosts 已登记该域名，指向 10.111.13.105，与 hub/mirror/nexus 同一个 k3s 节点。看到首次登录页，见图 2：用户名 &lt;code&gt;admin&lt;/code&gt; + 上一节取到的初始密码。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/02-grafana-login.png&quot; alt=&quot;Grafana 首次登录页&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 2：Grafana 首次登录页，admin + 初始密码&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;图 3 是 Rancher 里 grafana 命名空间的 Secret &lt;code&gt;grafana&lt;/code&gt; 页面，两项分别是 &lt;code&gt;admin-user&lt;/code&gt;，即用户名，固定为 admin，与 &lt;code&gt;admin-password&lt;/code&gt;，即初始密码。上一节那条 kubectl 命令，取的就是这个 Secret 的后者。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/03-grafana-admin-secret.png&quot; alt=&quot;Rancher 里 grafana 命名空间的 Secret grafana&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 3：Rancher 里 grafana 命名空间的 Secret&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;登录后顺手做一个小设置：把界面语言改成简体中文，入口在 个人设置 → 通用 → 语言。后文界面截图都是中文，见图 4。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/04-grafana-profile-zh.png&quot; alt=&quot;Grafana 个人设置：语言设为简体中文&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 4：Grafana 个人设置页：语言已设为简体中文&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;最后做一次“活了没“的健康检查：访问 Grafana 内置的健康端点 &lt;code&gt;https://grafana.kali-team.internal/api/health&lt;/code&gt;，实测返回：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;json&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;{&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;database&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;ok&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;, &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;version&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;13.2.4&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;, &amp;quot;&lt;/span&gt;&lt;span class=&quot;z-3&quot;&gt;commit&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;&amp;quot;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;0e79aef9d91abf3bdadae9af15763029072fb45b&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;database: ok&lt;/code&gt; 说明内部存储健康；&lt;code&gt;version: 13.2.4&lt;/code&gt; 是真实的应用版本，正好对上 chart 14.0.1。chart 版本与应用版本是两个独立的编号，别混淆：前者是“安装包的版本“，后者是“装出来软件本身的版本“。&lt;/p&gt;
&lt;h2 id=&quot;4-gitea-sso-grafana-jie-ru-tong-yi-deng-lu&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-gitea-sso-grafana-jie-ru-tong-yi-deng-lu&quot; aria-label=&quot;Anchor link for: 4-gitea-sso-grafana-jie-ru-tong-yi-deng-lu&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4 Gitea SSO：Grafana 接入统一登录&lt;/h2&gt;
&lt;h3 id=&quot;4-1-gitea-ce-jian-oauth2-ying-yong&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-1-gitea-ce-jian-oauth2-ying-yong&quot; aria-label=&quot;Anchor link for: 4-1-gitea-ce-jian-oauth2-ying-yong&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.1 Gitea 侧：建 OAuth2 应用&lt;/h3&gt;
&lt;p&gt;Gitea → 组织 dev-sec-ops → 设置 → 应用 → 新建 OAuth2 应用。图 5 即该应用的设置页，处于编辑状态：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;应用名称&lt;/strong&gt;：&lt;code&gt;Grafana&lt;/code&gt;，登录按钮和授权同意页上显示的名字；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;重定向 URL&lt;/strong&gt;：&lt;code&gt;https://grafana.kali-team.internal/login/generic_oauth&lt;/code&gt;。这是 Grafana 固定的回调地址，Gitea 授权完成后浏览器被送回这个地址完成登录闭环。&lt;strong&gt;协议和路径必须与 Grafana 的回调精确一致，一个字符都不能差&lt;/strong&gt;，差一点就是登录循环或 404，这是最常见的坑，详见“常见问题与坑”；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;机密客户端&lt;/strong&gt;：勾选，confidential client，指“能安全保管客户端密钥“的客户端。跑在服务端的 Web 应用属此类；与之相对的是跑在用户本地、守不住密钥的脚本类应用，即公有客户端。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;保存后 Gitea 颁发一对值：半公开的标识 &lt;strong&gt;Client ID&lt;/strong&gt;，与&lt;strong&gt;客户端密钥&lt;/strong&gt;，密钥等价于密码，只写进 Grafana 侧配置。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/05-gitea-oauth-app-grafana.png&quot; alt=&quot;Gitea 组织的 OAuth2 应用 Grafana&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 5：Gitea 的 OAuth2 应用设置&lt;/em&gt;&lt;/p&gt;
&lt;h3 id=&quot;4-2-grafana-ce-xin-jian-generic-oauth-shu-ju-yuan&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-2-grafana-ce-xin-jian-generic-oauth-shu-ju-yuan&quot; aria-label=&quot;Anchor link for: 4-2-grafana-ce-xin-jian-generic-oauth-shu-ju-yuan&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.2 Grafana 侧：新建 Generic OAuth 数据源&lt;/h3&gt;
&lt;p&gt;Grafana → Connections → Data sources → Add data source，即 连接 → 数据源 → 添加数据源，类型选 &lt;strong&gt;Generic OAuth&lt;/strong&gt;，见图 6：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Name&lt;/strong&gt;：&lt;code&gt;Gitea&lt;/code&gt;，登录按钮上显示的名字；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;OIDC 发现 URL&lt;/strong&gt;：&lt;code&gt;https://hub.kali-team.internal/.well-known/openid-configuration&lt;/code&gt;。这是 Gitea 的标准“自描述“文件。&lt;code&gt;.well-known/openid-configuration&lt;/code&gt; 是 OIDC 发现端点的行业约定路径，Grafana 拉取这个文件，就能自动识别 Gitea 的各个端点，不用手工逐个填。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/06-grafana-oidc-discovery.png&quot; alt=&quot;Grafana 新建 Generic OAuth 数据源&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 6：新建 Generic OAuth 数据源，填 OIDC 发现 URL&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;填完保存后，表单里的 &lt;strong&gt;Auth URL / Token URL / API URL&lt;/strong&gt; 等字段被自动填充，见图 7。这就是“发现“的结果：授权端点、令牌端点、用户信息端点，一次填全。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/07-grafana-oauth-autofill.png&quot; alt=&quot;发现后各端点自动填充&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 7：各端点自动填充&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;最后把上一节 Gitea 颁发的 &lt;strong&gt;Client ID&lt;/strong&gt; 与&lt;strong&gt;客户端密钥&lt;/strong&gt;填进表单，保存。&lt;/p&gt;
&lt;h3 id=&quot;4-3-yan-zheng-yong-gitea-shen-fen-jin-grafana&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#4-3-yan-zheng-yong-gitea-shen-fen-jin-grafana&quot; aria-label=&quot;Anchor link for: 4-3-yan-zheng-yong-gitea-shen-fen-jin-grafana&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
4.3 验证：用 Gitea 身份进 Grafana&lt;/h3&gt;
&lt;p&gt;退出 admin 账号回到登录页，表单上多了一个新入口：&lt;strong&gt;“Sign in with Gitea”&lt;/strong&gt;，见图 8。点它，浏览器被送到 Gitea 的授权确认页，见图 9：“Grafana 申请授权访问你的账户”，回调地址 grafana.kali-team.internal/login/generic_oauth 清清楚楚。点同意，浏览器自动回到 Grafana，人已经在里面了，&lt;strong&gt;全程没输一次 Grafana 密码&lt;/strong&gt;，输的是 Gitea 的。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/08-grafana-login-gitea.png&quot; alt=&quot;Grafana 登录页出现 Sign in with Gitea 按钮&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 8：Grafana 登录页出现 Gitea 登录按钮&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/09-gitea-consent-grafana.png&quot; alt=&quot;Gitea 授权确认页&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 9：Gitea 授权确认页&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;进入后，右上角用户菜单显示 Gitea 身份 &lt;strong&gt;Kali-Team&lt;/strong&gt;，账号 root@kali-team.internal，见图 10。这个账号是首次 SSO 登录时 Grafana 自动创建的，无需手工建号。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/10-grafana-explore-oidc.png&quot; alt=&quot;SSO 登录后的 Grafana Explore 页&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 10：SSO 登录成功，右上角显示 Kali-Team&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;登录链路通了。下一节给配置文件做一轮加固。&lt;/p&gt;
&lt;h2 id=&quot;5-grafana-ini-jia-gu-zhu-xiang&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#5-grafana-ini-jia-gu-zhu-xiang&quot; aria-label=&quot;Anchor link for: 5-grafana-ini-jia-gu-zhu-xiang&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
5 grafana.ini 加固逐项&lt;/h2&gt;
&lt;p&gt;Grafana 的配置文件是 &lt;code&gt;grafana.ini&lt;/code&gt;，INI 格式：&lt;code&gt;[section]&lt;/code&gt; 段落加 &lt;code&gt;key = value&lt;/code&gt; 键值对。chart 部署时这个文件被挂载进容器。改动 diff 如下，分布在文件中部与末尾两段：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;diff&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; -1,5 +1,5&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; [analytics]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;check_for_updates = true&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;check_for_updates = false&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; [log]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; mode = console&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; [paths]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; -10,6 +10,11&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; [plugins]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; preinstall_auto_update = false&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; [server]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;root_url = https://grafana.kali-team.internal&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; domain = grafana.kali-team.internal&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; [unified_storage]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; index_path = /var/lib/grafana-search/bleve&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;[plugins]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;allow_updates = false&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;check_for_updates = false&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;allow_loading_unsigned_plugins = false&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;[users]&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;auto_assign_org_role = Editor&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;diff 里出现了两个 &lt;code&gt;[plugins]&lt;/code&gt; 段落，这是 INI 文件合法写法：同名段落会被合并，同名键以后出现的值为准，本次部署实际生效，已验证。下面按 key 归并讲解：&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;code&gt;[server] root_url = https://grafana.kali-team.internal&lt;/code&gt;&lt;/strong&gt;：本章最重要的项。&lt;/p&gt;
&lt;p&gt;root_url 是“在 Grafana 自己看来，它被外部访问的地址“，&lt;strong&gt;必须与对外 URL 逐字符一致，包括协议&lt;/strong&gt;。Grafana 的很多行为都拿它当基准：OIDC 登录的回调要送回哪里、页面里相对链接怎么解析、邮件通知里的地址等。一旦不一致，比如写成 http 而实际是 https，或漏了域名，典型症状就是 &lt;strong&gt;OIDC 回调 404 或浏览器在 Gitea 与 Grafana 之间无限循环&lt;/strong&gt;，是这类部署最常见的坑。diff 里 &lt;code&gt;root_url&lt;/code&gt; 下一行的 &lt;code&gt;domain = grafana.kali-team.internal&lt;/code&gt; 是文件里原本就有的值，上下文行，未改动，供邮件模板等使用；&lt;code&gt;root_url&lt;/code&gt; 才是本次新增的。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;code&gt;[analytics] check_for_updates = false&lt;/code&gt;&lt;/strong&gt;：关闭“检查新版本“。 Grafana 默认会定期向公网发请求检查新版本；内网本来就到不了公网，关掉既避免无意义的请求，也避免把“当前版本是多少“这种信息往外暴露。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;code&gt;[plugins] allow_updates = false&lt;/code&gt; + &lt;code&gt;check_for_updates = false&lt;/code&gt;&lt;/strong&gt;：插件在线更新与更新检查全关。 这一条是供应链视角的安全加固：&lt;strong&gt;不让 Grafana 自己联网拉东西&lt;/strong&gt;。插件更新改由团队走人工流程，从审计过的渠道拿离线包，而不是让它“自动装一个新版本“。自动更新意味着某天 Grafana 里多了一个你不认识的插件，而且说不清它是从哪里、什么时候装进来的。diff 里的 &lt;code&gt;preinstall_auto_update = false&lt;/code&gt; 是原有值，预装插件同样不自动更新。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;code&gt;[plugins] allow_loading_unsigned_plugins = false&lt;/code&gt;&lt;/strong&gt;：只加载签名插件。 插件是运行在 Grafana 进程里的第三方代码，“签名“意味着插件带有可验证的来源签名。设为 false 就是拒绝加载未签名插件，只放行来源签名可验证的。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;&lt;code&gt;[users] auto_assign_org_role = Editor&lt;/code&gt;&lt;/strong&gt;：SSO 用户的初始角色。 经 SSO 首次登录的用户，进入组织时自动分配 Editor 角色，即刻可以干活。这里有一个便利与最小权限的取舍要说清楚：Grafana 的组织角色从低到高是 &lt;strong&gt;Viewer（查看者）&amp;lt; Editor（编辑者）&amp;lt; Admin（组织管理员）&lt;/strong&gt;：Editor 可以创建/修改仪表盘、做查询，但改不了组织级设置，成员增删、组织信息等那是 Admin 的权限。直接给 Editor 的好处是省掉了“进来先申请权限“这一步；想更严可以改成 Viewer，登录后只能看和查，不能创建/修改仪表盘，代价是用户想建仪表盘得找管理员。本环境选 Editor：内网 + SSO 已经把“谁能进来“管住了，进来的人默认给编辑权，便利优先。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;生效方式&lt;/strong&gt;：配置文件由 chart 挂载进容器，&lt;strong&gt;改完必须重启 Grafana 才生效&lt;/strong&gt;，本次的实际操作就是修改 grafana.ini 后重新启动。&lt;/p&gt;
&lt;h2 id=&quot;6-da-jian-loki&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#6-da-jian-loki&quot; aria-label=&quot;Anchor link for: 6-da-jian-loki&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
6 搭建 Loki&lt;/h2&gt;
&lt;h3 id=&quot;6-1-wei-shen-me-xuan-loki-bu-xuan-elk&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#6-1-wei-shen-me-xuan-loki-bu-xuan-elk&quot; aria-label=&quot;Anchor link for: 6-1-wei-shen-me-xuan-loki-bu-xuan-elk&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
6.1 为什么选 Loki 不选 ELK&lt;/h3&gt;
&lt;p&gt;说到“日志系统“，很多人第一反应是 ELK 组合，Elasticsearch、Logstash、Kibana 三件套。本环境选 Loki 的理由：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;索引成本&lt;/strong&gt;：Elasticsearch 对日志正文做&lt;strong&gt;全文索引&lt;/strong&gt;，正文里每个词都进索引，搜索能力极强，但索引巨大、内存和磁盘开销都高；Loki &lt;strong&gt;只索引标签、不索引正文&lt;/strong&gt;，索引通常比全文索引小得多；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;存储&lt;/strong&gt;：正文按&lt;strong&gt;压缩块&lt;/strong&gt;存放，存储便宜，同样预算能留更久的日志；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;生态&lt;/strong&gt;：与 Grafana 原生集成，数据源点几下就配好，Explore 查询页现成；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;规模匹配&lt;/strong&gt;：内网服务规模就几台机器、少量容器，用 ELK 属于大材小用。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;代价也如实说：全文关键词搜索不如 ES 灵活，LogQL 的行过滤语法 &lt;code&gt;|=&lt;/code&gt; 是“定位到日志流后逐行扫描“，不是查索引，超大流量下速度会吃亏。对本环境，完全够用。&lt;/p&gt;
&lt;h3 id=&quot;6-2-chart-jie-gou-yu-san-xiang-jue-ce&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#6-2-chart-jie-gou-yu-san-xiang-jue-ce&quot; aria-label=&quot;Anchor link for: 6-2-chart-jie-gou-yu-san-xiang-jue-ce&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
6.2 chart 结构与三项决策&lt;/h3&gt;
&lt;p&gt;Loki 同样从 grafana-community 仓库安装：&lt;strong&gt;chart 19.1.1（应用版本 3.7.9）&lt;/strong&gt;。loki chart 和 grafana chart 有个不同：它自带&lt;strong&gt;子 chart&lt;/strong&gt;（sub-chart），就是装在本 chart 里、随之一并部署的组件 chart。chart 页面，见图 11，可以看到 minio 与 rollout_operator 两个：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;minio&lt;/strong&gt;：开源对象存储（兼容 S3 API），作为 Loki 的&lt;strong&gt;存储后端&lt;/strong&gt;，日志正文最终写进这里；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;rollout_operator&lt;/strong&gt;：负责编排 Loki 服务的滚动更新。Loki 是有状态服务，更新流程比无状态服务讲究，细节以 chart 文档为准。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/11-rancher-loki-chart.png&quot; alt=&quot;Rancher 里的 loki chart 页面&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 11：Rancher UI 里的 loki chart 页面&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;部署决策就一句话：不需要租户隔离，开启 MinIO，加上持久化。逐项解释：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;不开租户隔离&lt;/strong&gt;：多租户，英文 tenant isolation，指多个团队共用一套 Loki、数据按租户互相隔离。开了之后，查询方必须在数据源侧配置 &lt;strong&gt;&lt;code&gt;X-Scope-OrgID&lt;/code&gt; 请求头&lt;/strong&gt;声明“我在查哪个租户“，详见“常见问题与坑“；本环境是单团队内网、一套用户，没这个复杂度需求，简单优先；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;开启 MinIO&lt;/strong&gt;：Loki 的正文要写进对象存储。为什么不直接写本地文件系统？本地磁盘绑死在单个节点上，扩容不方便、迁移不方便，节点更换数据就悬了；MinIO 是分布式对象存储，而且 chart 直接带了，开出来即用，具体开关项以 chart 文档为准；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;加持久化&lt;/strong&gt;：PVC，与 Grafana 开持久化同一个道理：索引与配置数据落持久存储，Pod 重建不丢日志。&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;说明：除下一节的内存分配调整外，其余具体 values 项不逐项展开，开关项以 loki chart 19.1.1 的官方文档为准。&lt;/p&gt;
&lt;h3 id=&quot;6-3-wang-luo-xing-tai-loki-zhi-zai-ji-qun-nei-ke-da&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#6-3-wang-luo-xing-tai-loki-zhi-zai-ji-qun-nei-ke-da&quot; aria-label=&quot;Anchor link for: 6-3-wang-luo-xing-tai-loki-zhi-zai-ji-qun-nei-ke-da&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
6.3 网络形态：Loki 只在集群内可达&lt;/h3&gt;
&lt;p&gt;Grafana 和 Loki 的“暴露姿态“是刻意不同的：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Grafana&lt;/strong&gt;：有对外域名 grafana.kali-team.internal，走 ingress + 内网证书，本机浏览器直接可达。它是入口，本来就要可达；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Loki&lt;/strong&gt;：&lt;strong&gt;对外走 ingress&lt;/strong&gt;。本机 /etc/hosts 里只登记了 grafana 的域名，没有 loki.kali-team.internal；k3s 节点 IP 的 3100 端口，也就是 Loki 的服务端口。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;6-4-nei-cun-fen-pei-qi-dong-ti-shi-bu-gou-nei-cun-ke-yi-ba-allocatedmemory-diao-xiao&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#6-4-nei-cun-fen-pei-qi-dong-ti-shi-bu-gou-nei-cun-ke-yi-ba-allocatedmemory-diao-xiao&quot; aria-label=&quot;Anchor link for: 6-4-nei-cun-fen-pei-qi-dong-ti-shi-bu-gou-nei-cun-ke-yi-ba-allocatedmemory-diao-xiao&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
6.4 内存分配：启动提示不够内存，可以把 allocatedMemory 调小&lt;/h3&gt;
&lt;p&gt;values 还有一处真实调整，属于“启动遇到问题再修“的场景，单独拿出来讲。&lt;/p&gt;
&lt;p&gt;loki chart 的 values 给各组件声明了 &lt;code&gt;allocatedMemory&lt;/code&gt;，即内存配额，与 &lt;code&gt;allocatedCPU&lt;/code&gt;，即 CPU 配额。比如 &lt;code&gt;500m&lt;/code&gt; 就是 0.5 个核，m 是毫核，k8s 声明 CPU 的惯用单位。声明的作用是告诉 k8s：“这个组件要预留这么多资源”。&lt;strong&gt;如果声明值超过了节点上实际可用的内存，组件就调度不上去、起不来，也就是“启动提示不够内存“&lt;/strong&gt;。这时候的修法是：把声明值调小，先让它跑起来。&lt;/p&gt;
&lt;p&gt;diff 共两处，行号对应 values 文件：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;diff&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; -407,7 +407,7&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;     include &amp;quot;loki.namespace&amp;quot; $ }}.svc.{{ .Values.global.clusterDomain }}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   affinity: {}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   allocatedCPU: 500m&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  allocatedMemory: 8192&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  allocatedMemory: 1024&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   annotations: {}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   batchSize: 4&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   connectionLimit: 16384&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;@@&lt;/span&gt;&lt;span&gt; -429,7 +429,7&lt;/span&gt;&lt;span class=&quot;z-4&quot;&gt; @@&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; }}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   affinity: {}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   allocatedCPU: 500m&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;-&lt;/span&gt;&lt;span class=&quot;z-11&quot;&gt;  allocatedMemory: 8192&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;  allocatedMemory: 1024&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   annotations: {}&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   batchSize: 4&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   connectionLimit: 16384&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;给读者的用法：如果你的节点内存比本环境小，部署前可以先把这两项调小；如果部署后启动提示不够内存，优先减 &lt;code&gt;allocatedMemory&lt;/code&gt;，它属于&lt;strong&gt;资源声明&lt;/strong&gt;，不是功能配置，调小不会改变 Loki 本身的行为。声明太低会导致组件内存不足被杀，调的时候留点余量，以 chart 文档为准。&lt;/p&gt;
&lt;h2 id=&quot;7-jie-tong-yu-cha-xun&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#7-jie-tong-yu-cha-xun&quot; aria-label=&quot;Anchor link for: 7-jie-tong-yu-cha-xun&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
7 接通与查询&lt;/h2&gt;
&lt;h3 id=&quot;7-1-grafana-jia-loki-shu-ju-yuan&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#7-1-grafana-jia-loki-shu-ju-yuan&quot; aria-label=&quot;Anchor link for: 7-1-grafana-jia-loki-shu-ju-yuan&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
7.1 Grafana 加 Loki 数据源&lt;/h3&gt;
&lt;p&gt;Grafana → Connections → Data sources → Add data source，类型选 &lt;strong&gt;Loki&lt;/strong&gt;。图 12 是配好后的数据源列表，Loki 已存在并设为默认：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/12-grafana-datasource-list.png&quot; alt=&quot;Grafana 数据源列表&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 12：Grafana 数据源列表&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;设置页见图 13，关键项：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/13-loki-datasource-settings.png&quot; alt=&quot;Loki 数据源设置&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 13：Loki 数据源设置&lt;/em&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Name&lt;/strong&gt;：&lt;code&gt;Loki&lt;/code&gt;；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;URL&lt;/strong&gt;：&lt;code&gt;http://loki.grafana.svc.cluster.local:3100&lt;/code&gt;。注意这是&lt;strong&gt;集群内服务地址&lt;/strong&gt;，k8s 集群内 DNS 名的固定格式是 服务名.命名空间.svc.cluster.local，不是对外域名。Grafana 与 Loki 同在一个集群里，走内网互通，正好对应上面说的“只在集群内可达“；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Authentication&lt;/strong&gt;：&lt;strong&gt;No Authentication&lt;/strong&gt;。集群内的 Loki 服务本身没有鉴权层。别急着觉得“裸奔“：本环境的边界画在“集群内可达 + 入口有 SSO“上，集群外根本到不了 Loki，上面实测过。如果将来需要数据面鉴权，可以在 Loki 前再加一层，以官方文档为准；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Default&lt;/strong&gt;：勾选，设为默认数据源，Explore 页默认就用 Loki。&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id=&quot;7-2-explore-pao-di-yi-tiao-logql-cha-xun&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#7-2-explore-pao-di-yi-tiao-logql-cha-xun&quot; aria-label=&quot;Anchor link for: 7-2-explore-pao-di-yi-tiao-logql-cha-xun&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
7.2 Explore：跑第一条 LogQL 查询&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;LogQL&lt;/strong&gt;，全称 Log Query Language，是 Loki 的查询语言。它的形态和 PromQL，Prometheus 的查询语言，很像。区别在于：PromQL 过滤的是&lt;strong&gt;指标&lt;/strong&gt;，LogQL 过滤的是&lt;strong&gt;日志流&lt;/strong&gt;，即标签集合相同的一组日志的连续流，可以理解为“同一个来源的一条日志管道“。&lt;/p&gt;
&lt;p&gt;打开 &lt;strong&gt;Explore&lt;/strong&gt;，左侧导航的“探索“入口，专为“对着单个数据源自由查询“设计的页面。选 Loki 数据源，输入：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;plain&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;{app=&amp;quot;watchtower&amp;quot;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;这是最简单的形态：&lt;strong&gt;标签选择器&lt;/strong&gt;，“把 app 标签等于 watchtower 的日志流全查出来”。watchtower 是业务主机上的镜像自动更新容器，它的日志已经通过 Docker 驱动流入 Loki。实际查询结果见图 14。&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;https://blog.kali-team.cn/blog/2026/09/%E5%AE%89%E5%85%A8%E5%BC%80%E5%8F%91-Grafana%E4%B8%8ELoki/14-loki-explore-query.png&quot; alt=&quot;Explore 查询 watchtower 日志&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&lt;em&gt;图 14：watchtower 的 LogQL 查询结果&lt;/em&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;LogQL 速查表&lt;/strong&gt;，日常够用，以下均可在本环境直接跑：&lt;/p&gt;
&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;语法&lt;/th&gt;&lt;th&gt;名称&lt;/th&gt;&lt;th&gt;含义&lt;/th&gt;&lt;th&gt;示例&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;{label=&quot;value&quot;}&lt;/code&gt;&lt;/td&gt;&lt;td&gt;标签选择器&lt;/td&gt;&lt;td&gt;按流标签过滤日志流&lt;/td&gt;&lt;td&gt;&lt;code&gt;{app=&quot;watchtower&quot;}&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;`&lt;/td&gt;&lt;td&gt;= “text”`&lt;/td&gt;&lt;td&gt;行过滤&lt;/td&gt;&lt;td&gt;流内只保留包含某文本的行&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;!= &quot;text&quot;&lt;/code&gt;&lt;/td&gt;&lt;td&gt;行排除&lt;/td&gt;&lt;td&gt;流内只保留不包含某文本的行&lt;/td&gt;&lt;td&gt;&lt;code&gt;{app=&quot;watchtower&quot;} != &quot;debug&quot;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;输入时&lt;/td&gt;&lt;td&gt;标签值自动补全&lt;/td&gt;&lt;td&gt;输入 &lt;code&gt;{app=&lt;/code&gt; 时页面下拉列出已有的标签值，值不用记&lt;/td&gt;&lt;td&gt;&lt;code&gt;{app=&lt;/code&gt; → 下拉可见 watchtower&lt;/td&gt;&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;读法：&lt;strong&gt;标签选择器回答“哪些流“，行过滤回答“流里哪些行“&lt;/strong&gt;：先按标签缩小范围，这一步走索引，快，再逐行过滤，这一步是扫描，稍慢。这个“两级过滤“正是 Loki“只索引标签“设计的直接体现。&lt;/p&gt;
&lt;h3 id=&quot;7-3-du-tu-14-ri-zhi-juan-tu-common-labels-ri-zhi-xing&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#7-3-du-tu-14-ri-zhi-juan-tu-common-labels-ri-zhi-xing&quot; aria-label=&quot;Anchor link for: 7-3-du-tu-14-ri-zhi-juan-tu-common-labels-ri-zhi-xing&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
7.3 读图 14：日志卷图、Common labels、日志行&lt;/h3&gt;
&lt;p&gt;把图 14 从上到下读一遍：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;日志卷图，顶部&lt;/strong&gt;：横轴是时间，纵轴是“每秒日志条数“，图例按日志级别区分，图里能看到 &lt;strong&gt;debug / info&lt;/strong&gt; 两个级别。这张图看服务的日志量走势：突刺、周期性峰值、突然停摆，一眼可见；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Common labels 行，中部&lt;/strong&gt;：列出本次结果的公共标签：&lt;code&gt;app=watchtower&lt;/code&gt;、&lt;code&gt;compose_project=watchtower&lt;/code&gt;、&lt;code&gt;compose_service=watchtower&lt;/code&gt;，另有 6 个字段，界面上折叠显示。这三个标签哪来的？&lt;strong&gt;来自收集侧 Docker 驱动的 &lt;code&gt;labels&lt;/code&gt; 选项&lt;/strong&gt;：驱动把容器/compose 标签“提升“为 Loki 流标签。&lt;code&gt;compose_project&lt;/code&gt; / &lt;code&gt;compose_service&lt;/code&gt; 是 docker compose 自动给容器打的项目名/服务名标签，&lt;code&gt;app&lt;/code&gt; 是 compose 文件里声明的标签；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;日志行，下部&lt;/strong&gt;：每行结构是 &lt;strong&gt;时间戳 + 级别 + 正文&lt;/strong&gt;，正文含结构化字段。行首是时间戳，然后是级别，比如 DEBUG / INFO，正文里带若干键值对字段。&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;8-jie-ru-xin-fu-wu-docker-loki-ri-zhi-qu-dong&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#8-jie-ru-xin-fu-wu-docker-loki-ri-zhi-qu-dong&quot; aria-label=&quot;Anchor link for: 8-jie-ru-xin-fu-wu-docker-loki-ri-zhi-qu-dong&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
8 接入新服务：Docker Loki 日志驱动&lt;/h2&gt;
&lt;p&gt;上面的整体架构里，收集侧目前只有一条“活“的日志流，watchtower。其他服务怎么接进来？这一节讲 &lt;strong&gt;Docker Loki 日志驱动&lt;/strong&gt;，Loki 官方提供的 Docker 日志插件：&lt;strong&gt;应用本身一行代码不用改&lt;/strong&gt;，Docker 守护进程把容器的 stdout/stderr 顺手交给驱动，驱动批量推给 Loki。&lt;/p&gt;
&lt;p&gt;这一节所有地址/凭据一律用占位符，使用时替换成你自己环境里的实际值。&lt;/p&gt;
&lt;h3 id=&quot;8-1-shou-ji-ce-ji-qi-an-zhuang-cha-jian&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#8-1-shou-ji-ce-ji-qi-an-zhuang-cha-jian&quot; aria-label=&quot;Anchor link for: 8-1-shou-ji-ce-ji-qi-an-zhuang-cha-jian&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
8.1 收集侧机器：安装插件&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;Docker 插件&lt;/strong&gt; plugin 是给 Docker 守护进程加载的扩展包，日志驱动本质上就是守护进程“日志处理管道“上多出来的一段。在跑业务容器的那台机器，也就是收集侧，上执行：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;docker&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; plugin install grafana/loki-docker-driver:3.7.x-amd64 --alias loki --grant-all-permissions&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;ul&gt;
&lt;li&gt;镜像 tag &lt;strong&gt;与当前 Loki 的主版本对齐&lt;/strong&gt;。本环境 Loki 应用是 3.7.9，所以用 3.7.x 系列的 tag，具体可用 tag 以插件官方文档为准；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;--alias loki&lt;/code&gt;：给插件起别名 &lt;code&gt;loki&lt;/code&gt;，后面 compose 文件里直接写 &lt;code&gt;driver: loki&lt;/code&gt;，不用写全称；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;--grant-all-permissions&lt;/code&gt;：插件要读容器日志、要往外发网络请求，需要多项守护进程权限，这个参数一次性全部授权，跳过逐项确认弹窗。授权了哪些权限可用 &lt;code&gt;docker plugin inspect loki&lt;/code&gt; 查看。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;验证 / 升级 / 卸载各一句：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;docker&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; plugin ls&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;    # 验证：看到 loki 别名且状态为 active&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;# 升级：用新版本 tag 重新执行上面的 install 命令（以插件官方文档为准）&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;docker&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; plugin rm loki&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;    # 卸载&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;h3 id=&quot;8-2-docker-compose-gei-fu-wu-jia-loki-ri-zhi-qu-dong&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#8-2-docker-compose-gei-fu-wu-jia-loki-ri-zhi-qu-dong&quot; aria-label=&quot;Anchor link for: 8-2-docker-compose-gei-fu-wu-jia-loki-ri-zhi-qu-dong&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
8.2 docker-compose：给服务加 loki 日志驱动&lt;/h3&gt;
&lt;p&gt;要接入的服务，在其 &lt;code&gt;docker-compose.yml&lt;/code&gt; 的服务块里加一个 &lt;code&gt;logging&lt;/code&gt; 段：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;yaml&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;services&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;  example-be&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;                    # 你的既有服务&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;    image&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; example-be:latest&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;    logging&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;                     # 新增：日志改走 loki 驱动&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;      driver&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; loki&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;               # 上面安装的插件别名&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;      options&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        loki-url&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;https://loki:loki_password@loki.kali-team.internal/loki/api/v1/push&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;   # 推送目标：Loki 的 push API 完整地址，本环境添加鉴权&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        loki-retries&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;3&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;        # 推送失败重试次数&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        loki-batch-size&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;10&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;    # 每批最多推多少条日志，批量发送，不是一条一条发&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3&quot;&gt;        labels&lt;/span&gt;&lt;span class=&quot;z-1&quot;&gt;:&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; &amp;quot;app,compose_project,compose_service&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-4 z-i&quot;&gt;   # 哪些容器/compose 标签提升为 Loki 流标签，逗号分隔&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;配置项说明：&lt;/p&gt;
&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;配置项&lt;/th&gt;&lt;th&gt;含义&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;loki-url&lt;/code&gt;&lt;/td&gt;&lt;td&gt;驱动推日志的地址。按插件官方文档，这里填 &lt;strong&gt;Loki push API 的完整地址&lt;/strong&gt;，即 &lt;code&gt;https://loki:loki_password@loki.kali-team.internal/loki/api/v1/push&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;loki-retries&lt;/code&gt;&lt;/td&gt;&lt;td&gt;一次推送失败后重试的次数，默认 3&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;loki-batch-size&lt;/code&gt;&lt;/td&gt;&lt;td&gt;每批最多装多少条日志，默认 10&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;&lt;code&gt;labels&lt;/code&gt;&lt;/td&gt;&lt;td&gt;&lt;strong&gt;把指定的容器/compose 标签提升为 Loki 流标签&lt;/strong&gt;，逗号分隔。这正是图 14 Common labels 的来源：&lt;code&gt;compose_project&lt;/code&gt; / &lt;code&gt;compose_service&lt;/code&gt; 是 compose 自动打的项目名/服务名标签，&lt;code&gt;app&lt;/code&gt; 是 compose 文件里声明的标签&lt;/td&gt;&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;给已有服务补 logging 的 diff 小例：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;diff&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt; services:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;   example-be:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span&gt;     image: example-be:latest&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;    logging:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      driver: loki&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;      options:&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;        loki-url: &amp;quot;https://loki:loki_password@loki.kali-team.internal/loki/api/v1/push&amp;quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;        loki-retries: &amp;quot;3&amp;quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;        loki-batch-size: &amp;quot;10&amp;quot;&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-4&quot;&gt;+&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt;        labels: &amp;quot;app,compose_project,compose_service&amp;quot;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;改完 &lt;code&gt;docker compose up -d&lt;/code&gt; 重建对应服务生效，之后的新日志就走 loki 驱动了。&lt;/p&gt;
&lt;h3 id=&quot;8-3-lian-tong-xing-zi-ce-curl-tui-yi-tiao-ce-shi-ri-zhi&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#8-3-lian-tong-xing-zi-ce-curl-tui-yi-tiao-ce-shi-ri-zhi&quot; aria-label=&quot;Anchor link for: 8-3-lian-tong-xing-zi-ce-curl-tui-yi-tiao-ce-shi-ri-zhi&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
8.3 连通性自测：curl 推一条测试日志&lt;/h3&gt;
&lt;p&gt;正式接服务之前，先自测“收集侧到 Loki 这条路通不通“：用 curl 直接向 push API 推一条测试日志，地址与上面的 &lt;code&gt;loki-url&lt;/code&gt; 相同：&lt;/p&gt;
&lt;pre class=&quot;giallo z-code&quot; &gt;&lt;code data-lang=&quot;shellscript&quot;&gt;&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-3 z-i&quot;&gt;curl&lt;/span&gt;&lt;span class=&quot;z-7&quot;&gt; -XPOST &amp;quot;https://loki:loki_password@loki.kali-team.internal/loki/api/v1/push&amp;quot;&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  -H &amp;#39;Content-Type: application/json&amp;#39;&lt;/span&gt;&lt;span class=&quot;z-16&quot;&gt; \&lt;/span&gt;&lt;/span&gt;
&lt;span class=&quot;giallo-l&quot;&gt;&lt;span class=&quot;z-7&quot;&gt;  -d &amp;#39;{&amp;quot;streams&amp;quot;:[{&amp;quot;stream&amp;quot;:{&amp;quot;app&amp;quot;:&amp;quot;selftest&amp;quot;},&amp;quot;values&amp;quot;:[[&amp;quot;&amp;lt;纳秒时间戳&amp;gt;&amp;quot;,&amp;quot;hello from selftest&amp;quot;]]}]}&amp;#39;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;拆开看请求体，Loki push API 的格式，以官方文档为准：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;最外层 &lt;code&gt;streams&lt;/code&gt; 是数组，一次可以推多条流；&lt;/li&gt;
&lt;li&gt;每条流的 &lt;code&gt;stream&lt;/code&gt; 字段是&lt;strong&gt;标签集合&lt;/strong&gt;，决定这批日志属于哪条流；&lt;/li&gt;
&lt;li&gt;&lt;code&gt;values&lt;/code&gt; 是 &lt;code&gt;[时间戳, 日志行]&lt;/code&gt; 的数组。注意时间戳单位是&lt;strong&gt;纳秒&lt;/strong&gt;，这是 Loki 要求的格式，用秒级时间戳会报 400。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;然后到 Grafana 的 Explore 里跑 &lt;code&gt;{app=&quot;selftest&quot;}&lt;/code&gt;：能查到 “hello from selftest” 这行，说明“收集侧 → Loki → Grafana“整条链路已通。&lt;/p&gt;
&lt;h3 id=&quot;8-4-dui-bi-docker-qu-dong-vs-ying-yong-nei-tui-song&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#8-4-dui-bi-docker-qu-dong-vs-ying-yong-nei-tui-song&quot; aria-label=&quot;Anchor link for: 8-4-dui-bi-docker-qu-dong-vs-ying-yong-nei-tui-song&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
8.4 对比：Docker 驱动 vs 应用内推送&lt;/h3&gt;
&lt;p&gt;接入日志还有另一条路：&lt;strong&gt;应用内推送&lt;/strong&gt;，在代码里集成日志客户端，把日志主动发给 Loki，可以顺带把请求 ID、用户 ID、业务流程 ID 等作为结构化字段一并发出。两种方式对比：&lt;/p&gt;
&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;&lt;/th&gt;&lt;th&gt;Docker 驱动，本章&lt;/th&gt;&lt;th&gt;应用内推送&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;
&lt;tr&gt;&lt;td&gt;采集对象&lt;/td&gt;&lt;td&gt;容器 stdout/stderr&lt;/td&gt;&lt;td&gt;代码主动发出的内容，可做结构化&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;对应用的侵入&lt;/td&gt;&lt;td&gt;&lt;strong&gt;透明&lt;/strong&gt;，应用不知道自己日志被采集了&lt;/td&gt;&lt;td&gt;要集成客户端、改代码&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;数据形态&lt;/td&gt;&lt;td&gt;原始文本行&lt;/td&gt;&lt;td&gt;结构化字段更丰富，级别/追踪 ID/业务字段&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td&gt;适用场景&lt;/td&gt;&lt;td&gt;“先把所有容器的日志集中起来”&lt;/td&gt;&lt;td&gt;关键服务的业务级日志分析&lt;/td&gt;&lt;/tr&gt;
&lt;/tbody&gt;&lt;/table&gt;
&lt;p&gt;两者&lt;strong&gt;不是二选一，可以共存&lt;/strong&gt;：驱动管“保底“，所有容器的 stdout 都不漏；应用内推送管“增强“，关键服务把业务语义发出来。新服务接入，从驱动开始，它是接入集中式日志系统成本最低的一步。&lt;/p&gt;
&lt;h2 id=&quot;9-chang-jian-wen-ti-yu-keng&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#9-chang-jian-wen-ti-yu-keng&quot; aria-label=&quot;Anchor link for: 9-chang-jian-wen-ti-yu-keng&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
9 常见问题与坑&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;root_url 与对外 URL 不一致：OIDC 回调 404 / 无限循环&lt;/strong&gt;，最常见的坑
症状：点“Sign in with Gitea“后，浏览器在 Gitea 与 Grafana 之间来回跳，或最终 404。原因：回调地址以 &lt;code&gt;root_url&lt;/code&gt; 为基准计算，它与真实对外 URL 在协议或域名上差一点，比如 http 对 https，Gitea 送回的地址就和注册的“重定向 URL“对不上，闭环断掉。修复：&lt;code&gt;root_url&lt;/code&gt; 与对外 URL 逐字符对齐，含 https，同时核对 Gitea 侧重定向 URL 也一致。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;开了租户隔离后，数据源查不到 / 403&lt;/strong&gt;
本环境没开租户隔离；如果开了，查询必须声明“查哪个租户“：在 Grafana 数据源侧配置 &lt;strong&gt;&lt;code&gt;X-Scope-OrgID&lt;/code&gt; 请求头&lt;/strong&gt;。不配的话典型症状是查询结果为空或 403。修复：数据源的 HTTP 头设置里加 &lt;code&gt;X-Scope-OrgID: &amp;lt;租户名&amp;gt;&lt;/code&gt;，细节以 Loki 多租户文档为准。&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;高基数字段别做成标签&lt;/strong&gt;
请求 ID、用户 ID、会话 ID 这类“基本每条日志都不同“的值，&lt;strong&gt;不要&lt;/strong&gt;放进标签，也就是不要写进 compose 文件 &lt;code&gt;logging&lt;/code&gt; 段的 &lt;code&gt;labels&lt;/code&gt; 选项里。Loki 只索引标签，每个标签组合就是一条流、都要记进索引。把这些值做成标签，标签组合数会爆炸 → 索引膨胀、内存/磁盘膨胀、查询变慢。正确姿势：把这类值放在&lt;strong&gt;正文&lt;/strong&gt;或正文的结构化字段里，需要时用 &lt;code&gt;|=&lt;/code&gt; 行过滤找。扫描有成本但可控。&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;10-xiao-jie&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#10-xiao-jie&quot; aria-label=&quot;Anchor link for: 10-xiao-jie&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
10 小结&lt;/h2&gt;
&lt;p&gt;这一篇把内网 DevSecOps 体系的“发生了什么“层接上了：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Grafana&lt;/strong&gt;，chart 14.0.1 / 应用 13.2.4：values 两处改动，ingress 开域名 + persistence 开持久化；初始密码用 kubectl 从 Secret 里取、&lt;strong&gt;首登立即修改&lt;/strong&gt;；Gitea SSO 走 Generic OAuth，OIDC 发现 URL 自动填充；grafana.ini 一轮加固：root_url 逐字符一致、更新检查与插件在线更新全关、只加载签名插件、SSO 新用户直接 Editor；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Loki&lt;/strong&gt;，chart 19.1.1 / 应用 3.7.9：不开租户隔离 + MinIO 对象存储 + 持久化；只在集群内可达，&lt;strong&gt;日志不出集群&lt;/strong&gt;；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;接通与查询&lt;/strong&gt;：Loki 数据源，集群内服务地址、No Authentication、设为默认；LogQL 速查表，标签选择器 + 行过滤/排除 + 自动补全；图 14 读法，日志卷图 / Common labels / 日志行结构；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;接入新服务&lt;/strong&gt;：Docker Loki 日志驱动，装插件 → compose 加 logging 段 → curl 推测试日志自测，与应用内推送可共存。&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;至此观测闭环齐了：&lt;strong&gt;状态页答“活没活“，Grafana + Loki 答“发生了什么“，日志。&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;下一步是配置工作：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;仪表盘&lt;/strong&gt;：把高频 LogQL 查询固化成一屏视图：日志量、错误行、按服务分布；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;告警&lt;/strong&gt;：Loki 告警规则 + 通知渠道，让日志满足条件时自动提醒，配置方式以官方文档为准；&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;扩大收集侧&lt;/strong&gt;：更多机器/服务接入 Docker 驱动，让“日志在哪台机“这件事彻底不用记。&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&quot;can-kao&quot;&gt;&lt;a class=&quot;header-anchor no-hover-padding&quot; href=&quot;#can-kao&quot; aria-label=&quot;Anchor link for: can-kao&quot;&gt;&lt;span class=&quot;link-icon&quot; aria-hidden=&quot;true&quot;&gt;&lt;/span&gt;&lt;/a&gt;
参考&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://grafana.com/docs/grafana/&quot;&gt;Grafana 官方文档&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://github.com/grafana-community/helm-charts&quot;&gt;grafana-community Helm charts，本部署 chart 仓库 https://grafana-community.github.io/helm-charts&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://grafana.com/docs/loki/latest/&quot;&gt;Loki 官方文档&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a class=&quot;external&quot; rel=&quot;noopener nofollow noreferrer external&quot; target=&quot;_blank&quot; href=&quot;https://github.com/grafana/loki-docker-driver&quot;&gt;grafana/loki-docker-driver，Docker 日志驱动插件&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</content>
        <summary type="html">搭 Grafana + Loki</summary>
        </entry>
</feed>
