github.com/yankunsam/loki/v2@v2.6.3-0.20220817130409-389df5235c27/production/helm/promtail/README.md (about)

     1  # ⚠️  DEPRECATED - Promtail Helm Chart
     2  
     3  This chart was moved to <https://github.com/grafana/helm-charts>.
     4  
     5  ## Deploy Promtail only
     6  
     7  ```bash
     8  $ helm upgrade --install promtail loki/promtail --set "loki.serviceName=loki"
     9  ```
    10  
    11  ## Run Loki behind https ingress
    12  
    13  If Loki and Promtail are deployed on different clusters you can add an Ingress in front of Loki.
    14  By adding a certificate you create an https endpoint. For extra security enable basic authentication on the Ingress.
    15  
    16  In Promtail set the following values to communicate with https and basic auth
    17  
    18  ```
    19  loki:
    20    serviceScheme: https
    21    user: user
    22    password: pass
    23  ```
    24  
    25  ## Run promtail with syslog support
    26  
    27  In order to receive and process syslog message into promtail, the following changes will be necessary:
    28  
    29  * Review the [promtail syslog-receiver configuration documentation](/docs/clients/promtail/scraping.md#syslog-receiver)
    30  
    31  * Configure the promtail helm chart with the syslog configuration added to the `extraScrapeConfigs` section and associated service definition to listen for syslog messages. For example:
    32  
    33  ```yaml
    34  extraScrapeConfigs:
    35    - job_name: syslog
    36      syslog:
    37        listen_address: 0.0.0.0:1514
    38        labels:
    39          job: "syslog"
    40    relabel_configs:
    41      - source_labels: ['__syslog_message_hostname']
    42        target_label: 'host'
    43  syslogService:
    44    enabled: true
    45    type: LoadBalancer
    46    port: 1514
    47  ```
    48  
    49  ## Run promtail with systemd-journal support
    50  
    51  In order to receive and process syslog message into promtail, the following changes will be necessary:
    52  
    53  * Review the [promtail systemd-journal configuration documentation](/docs/clients/promtail/scraping.md#journal-scraping-linux-only)
    54  
    55  * Configure the promtail helm chart with the systemd-journal configuration added to the `extraScrapeConfigs` section and volume mounts for the promtail pods to access the log files. For example:
    56  
    57  ```yaml
    58  # Add additional scrape config
    59  extraScrapeConfigs:
    60    - job_name: journal
    61      journal:
    62        path: /var/log/journal
    63        max_age: 12h
    64        labels:
    65          job: systemd-journal
    66      relabel_configs:
    67        - source_labels: ['__journal__systemd_unit']
    68          target_label: 'unit'
    69        - source_labels: ['__journal__hostname']
    70          target_label: 'hostname'
    71  
    72  # Mount journal directory into promtail pods
    73  extraVolumes:
    74    - name: journal
    75      hostPath:
    76        path: /var/log/journal
    77  
    78  extraVolumeMounts:
    79    - name: journal
    80      mountPath: /var/log/journal
    81      readOnly: true
    82  ```
    83