Back to Charts

kibana

stable/kibana/README.md

latest15.2 KB
Original Source

kibana

CHART WAS DEPRECATED! USE THE OFFICIAL CHART INSTEAD @ https://github.com/elastic/helm-charts/tree/master/kibana

kibana is your window into the Elastic Stack. Specifically, it's an open source (Apache Licensed), browser-based analytics and search dashboard for Elasticsearch.

Pre-deprecation notice

As mentioned in #14935 we are planning on deprecating this chart in favour of the official Elastic Helm Chart. The Elastic Helm Chart supports version 7 of Kibana.

TL;DR;

console
$ helm install stable/kibana

Introduction

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

Installing the Chart

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

console
$ helm install stable/kibana --name my-release

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

NOTE : We notice that lower resource constraints given to the chart + plugins are likely not going to work well.

Uninstalling the Chart

To uninstall/delete the my-release deployment:

console
$ 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 kibana chart and their default values.

ParameterDescriptionDefault
affinitynode/pod affinitiesNone
envEnvironment variables to configure Kibana{}
envFromSecretsEnvironment variables from secrets to the cronjob container{}
envFromSecrets.*.from.secret- secretKeyRef.name used for environment variable
envFromSecrets.*.from.key- secretKeyRef.key used for environment variable
filesKibana configuration filesNone
livenessProbe.enabledlivenessProbe to be enabled?false
livenessProbe.pathpath for livenessProbe/status
livenessProbe.initialDelaySecondsnumber of seconds30
livenessProbe.timeoutSecondsnumber of seconds10
image.pullPolicyImage pull policyIfNotPresent
image.repositoryImage repositorydocker.elastic.co/kibana/kibana-oss
image.tagImage tag6.7.0
image.pullSecretsSpecify image pull secretsnil
commandline.argsadd additional commandline argsnil
ingress.enabledEnables Ingressfalse
ingress.annotationsIngress annotationsNone:
ingress.hostsIngress accepted hostnamesNone:
ingress.tlsIngress TLS configurationNone:
nodeSelectornode labels for pod assignment{}
podAnnotationsannotations to add to each pod{}
podLabelslabels to add to each pod{}
replicaCountdesired number of pods1
revisionHistoryLimitrevisionHistoryLimit3
serviceAccountNameDEPRECATED: use serviceAccount.namenil
serviceAccount.createcreate a serviceAccount to run the podfalse
serviceAccount.namename of the serviceAccount to createkibana.fullname
authProxyEnabledenables authproxy. Create container in extracontainersfalse
extraContainersSidecar containers to add to the kibana pod{}
extraVolumeMountsadditional volumemounts for the kibana pod[]
extraVolumesadditional volumes to add to the kibana pod[]
resourcespod resource requests & limits{}
priorityClassNamepriorityClassNamenil
service.externalPortexternal port for the service443
service.internalPortinternal port for the service4180
service.portNameservice port nameNone:
service.authProxyPortport to use when using sidecar authProxyNone:
service.externalIPsexternal IP addressesNone:
service.loadBalancerIPLoad Balancer IP addressNone:
service.loadBalancerSourceRangesLimit load balancer source IPs to list of CIDRs (where available))[]
service.nodePortNodePort value if service.type is NodePortNone:
service.typetype of serviceClusterIP
service.clusterIPstatic clusterIP or None for headless servicesNone:
service.annotationsKubernetes service annotationsNone:
service.labelsKubernetes service labelsNone:
service.selectorKubernetes service selector{}
tolerationsList of node taints to tolerate[]
dashboardImport.enabledEnable dashboard importfalse
dashboardImport.timeoutTime in seconds waiting for Kibana to be in green overall state60
dashboardImport.basePathCustomizing base path url during dashboard import/
dashboardImport.xpackauth.enabledEnable Xpack authfalse
dashboardImport.xpackauth.usernameOptional Xpack usernamemyuser
dashboardImport.xpackauth.passwordOptional Xpack passwordmypass
dashboardImport.dashboardsDashboards{}
plugins.enabledEnable installation of plugins.false
plugins.resetOptional : Remove all installed plugins before installing all new onesfalse
plugins.valuesList of plugins to install. FormatNone:
persistentVolumeClaim.enabledEnable PVC for pluginsfalse
persistentVolumeClaim.existingClaimUse your own PVC for pluginsfalse
persistentVolumeClaim.annotationsAdd your annotations for the PVC{}
persistentVolumeClaim.accessModesAcces mode to the PVCReadWriteOnce
persistentVolumeClaim.sizeSize of the PVC5Gi
persistentVolumeClaim.storageClassStorage class of the PVCNone:
readinessProbe.enabledreadinessProbe to be enabled?false
readinessProbe.pathpath for readinessProbe/status
readinessProbe.initialDelaySecondsnumber of seconds30
readinessProbe.timeoutSecondsnumber of seconds10
readinessProbe.periodSecondsnumber of seconds10
readinessProbe.successThresholdnumber of successes5
securityContext.enabledEnable security context (should be true for PVC)false
securityContext.allowPrivilegeEscalationAllow privilege escalationfalse
securityContext.runAsUserUser id to run in pods1000
securityContext.fsGroupfsGroup id to run in pods2000
extraConfigMapMountsAdditional configmaps to be mounted[]
deployment.annotationsAnnotations for deployment{}
initContainersInit containers to add to the kibana deployment{}
testFramework.enabledenable the test frameworktrue
testFramework.imagetest-framework image repository.dduportal/bats
testFramework.tagtest-framework image tag.0.4.0

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

  • The Kibana configuration files config properties can be set through the env parameter too.
  • All the files listed under this variable will overwrite any existing files by the same name in kibana config directory.
  • Files not mentioned under this variable will remain unaffected.
console
$ helm install stable/kibana --name my-release \
  --set=image.tag=v0.0.2,resources.limits.cpu=200m

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

console
$ helm install stable/kibana --name my-release -f values.yaml

Tip: You can use the default values.yaml

Dasboard import

  • A dashboard for dashboardImport.dashboards can be a JSON or a download url to a JSON file.

Upgrading

To 2.3.0

The default value of elasticsearch.url (for kibana < 6.6) has been removed in favor of elasticsearch.hosts (for kibana >= 6.6).