@marcos_feitoza/vector 1.0.0

package/.circleci/config.yml

@@ -0,0 +1,41 @@
+version: 2.1
+
+jobs:
+  release:
+    docker:
+      - image: circleci/node:latest
+    steps:
+      - checkout
+
+      - run:
+          name: Install dependencies
+          command: npm ci
+
+      - run:
+          name: Ensure full Git history
+          command: |
+            git fetch --prune --unshallow || true
+            git fetch --all --tags
+
+      - run:
+          name: Configure Git remote with GH_TOKEN
+          command: |
+            git config user.name "circleci-bot"
+            git config user.email "ci@users.noreply.github.com"
+            git remote set-url origin "https://x-access-token:${GH_TOKEN}@github.com/MarcosOps/vector.git"
+
+      - run:
+          name: Run semantic-release
+          command: npx semantic-release
+
+workflows:
+  release:
+    jobs:
+      - release:
+          context:
+            - shared-ci-secrets
+          filters:
+            branches:
+              only:
+                - main
+                - /^AB#.*/

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# 1.0.0 (2026-02-28)
+
+
+### Bug Fixes
+
+* fix app name ([430c934](https://github.com/MarcosOps/vector/commit/430c934004de7b0c2d6f7a00a00a06bedc589a45))
+* new yaml ([b1a7085](https://github.com/MarcosOps/vector/commit/b1a7085afb1bd7ae53fc743d0198fcfd69bf40c0))

package/README.md

@@ -0,0 +1,85 @@
+# Vector (Coletor de logs)
+
+Este repositório entrega o Vector como DaemonSet para coleta de logs dos pods.
+
+## Papel na arquitetura
+
+- Coleta `stdout/stderr` de pods no nó (`kubernetes_logs`).
+- Normaliza campos e labels para consulta no Loki/Grafana.
+- Encaminha para `Loki` em `http://loki.monitoring.svc.cluster.local:3100`.
+
+## Integração com Loki e Grafana
+
+Fluxo:
+
+1. Pod escreve log em stdout/stderr.
+2. Vector captura no nó.
+3. Transform `normalize` define:
+   - `namespace`
+   - `pod`
+   - `container`
+   - `node`
+   - `app` (fallback por labels e nomes)
+4. Sink Loki envia payload JSON + labels.
+5. Grafana consulta Loki com LogQL e usa labels para filtros (`namespace`, `app`, `pod`, `container`).
+
+## Arquivos principais
+
+- `helm/prod-values.yaml`: imagem, recursos e endpoint Loki.
+- `helm/templates/configmap.yaml`: pipeline Vector (`sources`, `transforms`, `sinks`).
+
+## Mapeamento de label `app`
+
+No transform atual, prioridade:
+
+1. `kubernetes.pod_labels.app`
+2. `kubernetes.pod_labels."app.kubernetes.io/name"`
+3. `kubernetes.pod_labels."app_kubernetes_io_name"`
+4. `kubernetes.pod_labels."app.kubernetes.io/instance"`
+5. `container`
+6. `pod`
+7. fallback `unknown`
+
+Isso reduz casos de `app="unknown"` no Grafana.
+
+## Verificação rápida
+
+- Pods do Vector:
+
+```bash
+kubectl -n monitoring get pods -l app.kubernetes.io/name=vector -o wide
+```
+
+- Logs do Vector:
+
+```bash
+kubectl -n monitoring logs -l app.kubernetes.io/name=vector --tail=200
+```
+
+- Teste no Grafana Explore (Loki):
+
+```logql
+{namespace="app"}
+```
+
+ou com app específico:
+
+```logql
+{namespace="app", app=~".*crypto.*"}
+```
+
+## Troubleshooting comum
+
+- Sem logs no Grafana:
+  - Validar endpoint do Loki no Vector.
+  - Conferir conectividade DNS/Service `loki.monitoring.svc.cluster.local`.
+- `app=unknown`:
+  - Revisar labels dos Deployments.
+  - Ajustar fallback do transform em `configmap.yaml`.
+- Alta cardinalidade:
+  - Evitar labels dinâmicas no app (IDs por requisição, etc.).
+
+## Convenções
+
+- Logs em JSON estruturado quando possível.
+- Labels estáveis: `app`, `namespace`, `pod`, `container`, `node`.

package/helm/Chart.yaml

@@ -0,0 +1,6 @@
+apiVersion: v2
+name: vector
+description: Vector daemonset to collect pod logs and send to Loki
+type: application
+version: 0.1.0
+appVersion: "0.53.0"

package/helm/prod-values.yaml

@@ -0,0 +1,19 @@
+image:
+  repository: timberio/vector
+  tag: "0.53.0-debian"
+  pullPolicy: IfNotPresent
+
+loki:
+  endpoint: http://loki.monitoring.svc.cluster.local:3100
+
+resources:
+  requests:
+    cpu: 100m
+    memory: 128Mi
+  limits:
+    cpu: 500m
+    memory: 512Mi
+
+nodeSelector: {}
+tolerations: []
+affinity: {}

package/helm/templates/clusterrole.yaml

@@ -0,0 +1,10 @@
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRole
+metadata:
+  name: vector
+  labels:
+    app.kubernetes.io/name: vector
+rules:
+  - apiGroups: [""]
+    resources: ["pods", "namespaces", "nodes"]
+    verbs: ["get", "list", "watch"]

package/helm/templates/clusterrolebinding.yaml

@@ -0,0 +1,14 @@
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRoleBinding
+metadata:
+  name: vector
+  labels:
+    app.kubernetes.io/name: vector
+roleRef:
+  apiGroup: rbac.authorization.k8s.io
+  kind: ClusterRole
+  name: vector
+subjects:
+  - kind: ServiceAccount
+    name: vector
+    namespace: {{ .Release.Namespace }}

package/helm/templates/configmap.yaml

@@ -0,0 +1,53 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: vector-config
+data:
+  vector.yaml: |
+    data_dir: /vector-data-dir
+
+    sources:
+      kubernetes_logs:
+        type: kubernetes_logs
+        self_node_name: ${VECTOR_SELF_NODE_NAME}
+
+    transforms:
+      normalize:
+        type: remap
+        inputs:
+          - kubernetes_logs
+        source: |
+          .namespace = .kubernetes.pod_namespace
+          .pod = .kubernetes.pod_name
+          .container = .kubernetes.container_name
+          .node = .kubernetes.pod_node_name
+          if exists(.kubernetes.pod_labels.app) && !is_null(.kubernetes.pod_labels.app) {
+            .app = .kubernetes.pod_labels.app
+          } else if exists(.kubernetes.pod_labels."app.kubernetes.io/name") && !is_null(.kubernetes.pod_labels."app.kubernetes.io/name") {
+            .app = .kubernetes.pod_labels."app.kubernetes.io/name"
+          } else if exists(.kubernetes.pod_labels."app_kubernetes_io_name") && !is_null(.kubernetes.pod_labels."app_kubernetes_io_name") {
+            .app = .kubernetes.pod_labels."app_kubernetes_io_name"
+          } else if exists(.kubernetes.pod_labels."app.kubernetes.io/instance") && !is_null(.kubernetes.pod_labels."app.kubernetes.io/instance") {
+            .app = .kubernetes.pod_labels."app.kubernetes.io/instance"
+          } else if exists(.container) && !is_null(.container) && .container != "" {
+            .app = .container
+          } else if exists(.pod) && !is_null(.pod) && .pod != "" {
+            .app = .pod
+          } else {
+            .app = "unknown"
+          }
+
+    sinks:
+      loki:
+        type: loki
+        inputs:
+          - normalize
+        endpoint: ${LOKI_ENDPOINT}
+        encoding:
+          codec: json
+        labels:
+          namespace: "{{`{{ namespace }}`}}"
+          pod: "{{`{{ pod }}`}}"
+          container: "{{`{{ container }}`}}"
+          node: "{{`{{ node }}`}}"
+          app: "{{`{{ app }}`}}"

package/helm/templates/daemonset.yaml

@@ -0,0 +1,74 @@
+apiVersion: apps/v1
+kind: DaemonSet
+metadata:
+  name: vector
+  labels:
+    app.kubernetes.io/name: vector
+spec:
+  selector:
+    matchLabels:
+      app.kubernetes.io/name: vector
+  template:
+    metadata:
+      labels:
+        app.kubernetes.io/name: vector
+    spec:
+      serviceAccountName: vector
+      containers:
+        - name: vector
+          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          env:
+            - name: VECTOR_CONFIG
+              value: /etc/vector/vector.yaml
+            - name: LOKI_ENDPOINT
+              value: {{ .Values.loki.endpoint | quote }}
+            - name: VECTOR_SELF_NODE_NAME
+              valueFrom:
+                fieldRef:
+                  apiVersion: v1
+                  fieldPath: spec.nodeName
+          ports:
+            - name: api
+              containerPort: 8686
+              protocol: TCP
+          resources:
+            {{- toYaml .Values.resources | nindent 12 }}
+          volumeMounts:
+            - name: config
+              mountPath: /etc/vector
+              readOnly: true
+            - name: var-log
+              mountPath: /var/log
+              readOnly: true
+            - name: var-lib
+              mountPath: /var/lib
+              readOnly: true
+            - name: data-dir
+              mountPath: /vector-data-dir
+      volumes:
+        - name: config
+          configMap:
+            name: vector-config
+        - name: var-log
+          hostPath:
+            path: /var/log
+        - name: var-lib
+          hostPath:
+            path: /var/lib
+        - name: data-dir
+          hostPath:
+            path: /var/lib/vector
+            type: DirectoryOrCreate
+      {{- with .Values.nodeSelector }}
+      nodeSelector:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.affinity }}
+      affinity:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.tolerations }}
+      tolerations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}

package/helm/templates/serviceaccount.yaml

@@ -0,0 +1,6 @@
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: vector
+  labels:
+    app.kubernetes.io/name: vector

package/helm/values.yaml

@@ -0,0 +1,19 @@
+image:
+  repository: timberio/vector
+  tag: "0.53.0-debian"
+  pullPolicy: IfNotPresent
+
+loki:
+  endpoint: http://loki.monitoring.svc.cluster.local:3100
+
+resources:
+  requests:
+    cpu: 100m
+    memory: 128Mi
+  limits:
+    cpu: 500m
+    memory: 512Mi
+
+nodeSelector: {}
+tolerations: []
+affinity: {}

package/package.json

@@ -0,0 +1,29 @@
+{
+    "name": "@marcos_feitoza/vector",
+    "version": "1.0.0",
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "release": "semantic-release"
+    },
+    "devDependencies": {
+        "semantic-release": "^18.0.0",
+        "@semantic-release/changelog": "^6.0.0",
+        "@semantic-release/git": "^10.0.0",
+        "@semantic-release/github": "^8.0.0"
+    },
+    "release": {
+        "branches": [
+            "main"
+        ],
+        "plugins": [
+            "@semantic-release/commit-analyzer",
+            "@semantic-release/release-notes-generator",
+            "@semantic-release/changelog",
+            "@semantic-release/npm",
+            "@semantic-release/github",
+            "@semantic-release/git"
+        ]
+    }
+}