docs: rewrite README with structured overview and quick start guide

Replaces the minimal project description with a comprehensive README
including a component overview table, quick start instructions, common
Ansible operations, and links to detailed documentation. Aligns with
Red Panda Approval™ standards.
This commit is contained in:
2026-03-03 12:49:06 +00:00
parent c7be03a743
commit b4d60f2f38
219 changed files with 34586 additions and 2 deletions

View File

@@ -0,0 +1,41 @@
auth_enabled: false
server:
http_listen_port: {{ loki_port }}
grpc_listen_port: {{ loki_grpc_port }}
common:
path_prefix: {{ loki_data_dir }}
storage:
filesystem:
chunks_directory: {{ loki_data_dir }}/chunks
rules_directory: {{ loki_data_dir }}/rules
replication_factor: 1
ring:
instance_addr: 127.0.0.1
kvstore:
store: inmemory
query_range:
results_cache:
cache:
embedded_cache:
enabled: true
max_size_mb: 100
schema_config:
configs:
- from: 2024-04-01
object_store: filesystem
store: tsdb
schema: v13
index:
prefix: index_
period: 24h
ruler:
alertmanager_url: http://{{ alertmanager_host }}:{{ alertmanager_port }}
# Red Panda Approved Configuration
analytics:
reporting_enabled: false

89
ansible/loki/deploy.yml Normal file
View File

@@ -0,0 +1,89 @@
---
- name: Deploy Loki to Prospero
hosts: ubuntu
become: true
tasks:
- name: Check if host has loki service
ansible.builtin.set_fact:
has_loki_service: "{{'loki' in services}}"
- name: Skip hosts without loki service
ansible.builtin.meta: end_host
when: not has_loki_service
- name: Add Grafana repository
ansible.builtin.deb822_repository:
name: grafana
types: [deb]
uris: https://apt.grafana.com
suites: [stable]
components: [main]
signed_by: https://apt.grafana.com/gpg.key
state: present
- name: Install Loki
become: true
ansible.builtin.apt:
name:
- loki
state: present
update_cache: true
- name: Create loki group
become: true
ansible.builtin.group:
name: "{{loki_group}}"
- name: Create loki user
become: true
ansible.builtin.user:
name: "{{loki_user}}"
comment: "{{loki_user}}"
group: "{{loki_group}}"
system: true
- name: Add group loki to ansible_user
become: true
ansible.builtin.user:
name: "{{ansible_user}}"
groups: "{{loki_group}}"
append: true
- name: Create loki directories
become: true
ansible.builtin.file:
path: "{{item}}"
owner: "{{loki_user}}"
group: "{{loki_group}}"
state: directory
mode: '750'
loop:
- "{{loki_data_dir}}"
- "{{loki_config_dir}}"
- name: Template Loki configuration
become: true
ansible.builtin.template:
src: "{{loki_config_file}}.j2"
dest: "{{loki_config_dir}}/{{loki_config_file}}"
owner: "{{loki_user}}"
group: "{{loki_group}}"
mode: '550'
notify: restart loki
- name: Reset SSH connection to apply group changes
meta: reset_connection
- name: Enable and start Loki service
become: true
ansible.builtin.systemd:
name: loki
enabled: true
state: started
handlers:
- name: restart loki
become: true
ansible.builtin.systemd:
name: loki
state: restarted