Back to Charts

⚠️ Repo Archive Notice

stable/seq/README.md

latest12.9 KB
Original Source

⚠️ Repo Archive Notice

As of Nov 13, 2020, charts in this repo will no longer be updated. For more information, see the Helm Charts Deprecation and Archive Notice, and Update.

Seq

Seq is the easiest way for development teams to capture, search and visualize structured log events!

DEPRECATION NOTICE

This chart is deprecated and no longer supported.

TL;DR;

bash
$ helm install stable/seq

Introduction

This chart bootstraps a Seq deployment on a Kubernetes cluster using the Helm package manager.

Prerequisites

  • Kubernetes 1.9+ with Beta APIs enabled
  • PV provisioner support in the underlying infrastructure

Installing the Chart

To install the chart with the release name my-release:

bash
$ helm install --name my-release seq

The command deploys Seq on the Kubernetes cluster in the default configuration. The configuration section lists the parameters that can be configured during installation.

Tip: List all releases using helm list

Uninstalling the Chart

To uninstall/delete the my-release deployment:

bash
$ helm delete my-release

The command removes all the Kubernetes components associated with the chart and deletes the release.

Configuration

The following table lists the configurable parameters of the Seq chart and their default values.

ParameterDescriptionDefault
image.repositoryImage repositorydatalust/seq
image.tagSeq image tag. Possible values listed here.2020
image.pullPolicyImage pull policyIfNotPresent
acceptEULAAccept EULAY
baseURIBase URL for ingress/AAD (see values.yaml)
service.typeKubernetes service typeClusterIP
ingress.annotationsIngress annotations{}
ingress.labelsCustom labels{}
ingress.tlsIngress TLS configuration[]
ui.service.portKubernetes port where the full API/UI is exposed80
ui.ingress.enabledEnable ingress on the full API/UIfalse
ui.ingress.pathIngress path/
ui.ingress.hostsIngress accepted hostnames[]
ingestion.service.portKubernetes port where the ingestion-only API is exposed5341
ingestion.ingress.enabledEnable ingress on the ingestion-only APIfalse
ingestion.ingress.pathIngress path/
ingestion.ingress.hostsIngress accepted hostnames[]
gelf.enabledEnable log ingestion using the GELF protocolfalse
gelf.apiKeyThe API key to use when forwarding events into Seq
gelf.image.repositoryImage repositorydatalust/sqelf
gelf.image.tagSqelf image tag2
gelf.image.pullPolicyImage pull policyIfNotPresent
gelf.service.portThe port to listen for GELF events on12201
gelf.service.protocolThe protocol to listen for GELF events on. Can be either UDP or TCP.TCP
persistence.enabledUse persistent volume to store datatrue
persistence.sizeSize of persistent volume claim8Gi
persistence.existingClaimUse an existing PVC to persist datanil
persistence.storageClassType of persistent volume claimgeneric
persistence.accessModeReadWriteOnce or ReadOnlyReadWriteOnce
persistence.subPathMount a sub directory of the persistent volume if set""
resourcesCPU/Memory resource requests/limits{}
cache.targetSizeThe target amount of RAM to use for the in-memory cache0.7
nodeSelectorNode labels for pod assignment{}
affinityAffinity settings for pod assignment{}
tolerationsToleration labels for pod assignment[]
serviceAccount.createSpecifies whether a ServiceAccount should be createdfalse
serviceAccount.nameThe name of the ServiceAccount to createGenerated using the fullname template
rbac.createSpecifies whether RBAC resources should be createdfalse
podSecurityPolicy.createSpecifies whether a PodSecurityPolicy should be createdfalse
livenessProbe.enabledEnable/disable the Liveness probetrue
livenessProbe.failureThresholdMinimum consecutive failures for the liveness probe to be considered failed after having succeeded3
livenessProbe.initialDelaySecondsDelay before liveness probe is initiated0
livenessProbe.periodSecondsHow often to perform the liveness probe10
livenessProbe.successThresholdMinimum consecutive successes for the liveness probe to be considered successful after having failed1
livenessProbe.timeoutSecondsWhen the liveness probe times out1
readinessProbe.enabledEnable/disable the Readiness probetrue
readinessProbe.failureThresholdMinimum consecutive failures for the readiness probe to be considered failed after having succeeded3
readinessProbe.initialDelaySecondsDelay before readiness probe is initiated0
readinessProbe.periodSecondsHow often to perform the readiness probe10
readinessProbe.successThresholdMinimum consecutive successes for the readiness probe to be considered successful after having failed1
readinessProbe.timeoutSecondsWhen the readiness probe times out1
startupProbe.enabledEnable/disable the Readiness probetrue
startupProbe.failureThresholdMinimum consecutive failures for the readiness probe to be considered failed after having succeeded30
startupProbe.periodSecondsHow often to perform the readiness probe10

Some of the parameters above map to the env variables defined in the Seq DockerHub image.

Specify each parameter using the --set key=value[,key=value] argument to helm install. For example,

bash
$ helm install --name my-release \
  --set persistence.size=8Gi \
    stable/seq

Alternatively, a YAML file that specifies the values for the parameters can be provided while installing the chart. For example,

bash
$ helm install --name my-release -f values.yaml stable/seq

Tip: You can use the default values.yaml

Persistence

The Seq image stores the Seq data and configurations at the /data path of the container.

By default, the chart mounts a Persistent Volume at this location. The volume is created using dynamic volume provisioning. If a Persistent Volume Claim already exists, specify it during installation.

Existing PersistentVolumeClaim

  1. Create the PersistentVolume
  2. Create the PersistentVolumeClaim
  3. Install the chart
bash
$ helm install --set persistence.existingClaim=PVC_NAME stable/seq