` Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. `
Apache SkyWalking is application performance monitor tool for distributed systems, especially designed for microservices, cloud native and container-based (Docker, K8s, Mesos) architectures.
This chart bootstraps a Apache SkyWalking deployment on a Kubernetes cluster using the Helm package manager.
To install the chart with the release name my-release
:
$ helm install my-release skywalking -n <namespace>
The command deploys Apache Skywalking 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
To uninstall/delete the my-release
deployment:
$ helm uninstall my-release -n <namespace>
The command removes all the Kubernetes components associated with the chart and deletes the release.
The following table lists the configurable parameters of the Skywalking chart and their default values.
Parameter | Description | Default |
---|---|---|
nameOverride | Override name | nil |
serviceAccounts.oap | Name of the OAP service account to use or create | nil |
oap.name | OAP deployment name | oap |
oap.image.repository | OAP container image name | apache/skywalking-oap-server |
oap.image.tag | OAP container image tag | 6.1.0 |
oap.image.pullPolicy | OAP container image pull policy | IfNotPresent |
oap.ports.grpc | OAP grpc port for tracing or metric | 11800 |
oap.ports.rest | OAP http port for Web UI | 12800 |
oap.replicas | OAP k8s deployment replicas | 2 |
oap.service.type | OAP svc type | ClusterIP |
oap.javaOpts | Parameters to be added to JAVA_OPTS environment variable for OAP | -Xms2g -Xmx2g |
oap.antiAffinity | OAP anti-affinity policy | soft |
oap.nodeAffinity | OAP node affinity policy | {} |
oap.nodeSelector | OAP labels for master pod assignment | {} |
oap.tolerations | OAP tolerations | [] |
oap.resources | OAP node resources requests & limits | {} - cpu limit must be an integer |
oap.envoy.als.enabled | Open envoy als | false |
oap.istio.adapter.enabled | Open istio adapter | false |
oap.env | OAP environment variables | [] |
ui.name | Web UI deployment name | ui |
ui.replicas | Web UI k8s deployment replicas | 1 |
ui.image.repository | Web UI container image name | apache/skywalking-ui |
ui.image.tag | Web UI container image tag | 6.1.0 |
ui.image.pullPolicy | Web UI container image pull policy | IfNotPresent |
ui.ingress.enabled | Create Ingress for Web UI | false |
ui.ingress.annotations | Associate annotations to the Ingress | {} |
ui.ingress.path | Associate path with the Ingress | / |
ui.ingress.hosts | Associate hosts with the Ingress | [] |
ui.ingress.tls | Associate TLS with the Ingress | [] |
ui.service.type | Web UI svc type | ClusterIP |
ui.service.externalPort | external port for the service | 80 |
ui.service.internalPort | internal port for the service | 8080 |
ui.service.externalIPs | external IP addresses | nil |
ui.service.loadBalancerIP | Load Balancer IP address | nil |
ui.service.annotations | Kubernetes service annotations | {} |
ui.service.loadBalancerSourceRanges | Limit load balancer source IPs to list of CIDRs (where available)) | [] |
elasticsearch.enabled | Spin up a new elasticsearch cluster for SkyWalking | true |
elasticsearch.client.name | client | Client component name |
elasticsearch.client.replicas | 2 | Client node replicas (deployment) |
elasticsearch.client.resources | {} - cpu limit must be an integer | Client node resources requests & limits |
elasticsearch.client.priorityClassName | nil | Client priorityClass |
elasticsearch.client.heapSize | 512m | Client node heap size |
elasticsearch.client.podAnnotations | {} | Client Deployment annotations |
elasticsearch.client.nodeSelector | {} | Node labels for client pod assignment |
elasticsearch.client.tolerations | [] | Client tolerations |
elasticsearch.client.serviceAnnotations | {} | Client Service annotations |
elasticsearch.client.serviceType | ClusterIP | Client service type |
elasticsearch.client.httpNodePort | nil | Client service HTTP NodePort port number. Has no effect if client.serviceType is not NodePort . |
elasticsearch.client.loadBalancerIP | {} | Client loadBalancerIP |
elasticsearch.client.loadBalancerSourceRanges | {} | Client loadBalancerSourceRanges |
elasticsearch.client.antiAffinity | soft | Client anti-affinity policy |
elasticsearch.client.nodeAffinity | {} | Client node affinity policy |
elasticsearch.client.initResources | {} | Client initContainer resources requests & limits |
elasticsearch.client.additionalJavaOpts | "" | Parameters to be added to ES_JAVA_OPTS environment variable for client |
elasticsearch.client.ingress.enabled | false | Enable Client Ingress |
elasticsearch.client.ingress.user | nil | If this & password are set, enable basic-auth on ingress |
elasticsearch.client.ingress.password | nil | If this & user are set, enable basic-auth on ingress |
elasticsearch.client.ingress.annotations | {} | Client Ingress annotations |
elasticsearch.client.ingress.hosts | [] | Client Ingress Hostnames |
elasticsearch.client.ingress.tls | [] | Client Ingress TLS configuration |
elasticsearch.client.exposeTransportPort | false | Expose transport port 9300 on client service (ClusterIP) |
elasticsearch.master.initResources | {} | Master initContainer resources requests & limits |
elasticsearch.master.additionalJavaOpts | "" | Parameters to be added to ES_JAVA_OPTS environment variable for master |
elasticsearch.master.exposeHttp | false | Expose http port 9200 on master Pods for monitoring, etc |
elasticsearch.master.name | master | Master component name |
elasticsearch.master.replicas | 2 | Master node replicas (deployment) |
elasticsearch.master.resources | {} - cpu limit must be an integer | Master node resources requests & limits |
elasticsearch.master.priorityClassName | nil | Master priorityClass |
elasticsearch.master.podAnnotations | {} | Master Deployment annotations |
elasticsearch.master.nodeSelector | {} | Node labels for master pod assignment |
elasticsearch.master.tolerations | [] | Master tolerations |
elasticsearch.master.heapSize | 512m | Master node heap size |
elasticsearch.master.name | master | Master component name |
elasticsearch.master.persistence.enabled | false | Master persistent enabled/disabled |
elasticsearch.master.persistence.name | data | Master statefulset PVC template name |
elasticsearch.master.persistence.size | 4Gi | Master persistent volume size |
elasticsearch.master.persistence.storageClass | nil | Master persistent volume Class |
elasticsearch.master.persistence.accessMode | ReadWriteOnce | Master persistent Access Mode |
elasticsearch.master.readinessProbe | see values.yaml for defaults | Master container readiness probes |
elasticsearch.master.antiAffinity | soft | Master anti-affinity policy |
elasticsearch.master.nodeAffinity | {} | Master node affinity policy |
elasticsearch.master.podManagementPolicy | OrderedReady | Master pod creation strategy |
elasticsearch.master.updateStrategy | {type: "onDelete"} | Master node update strategy policy |
elasticsearch.data.initResources | {} | Data initContainer resources requests & limits |
elasticsearch.data.additionalJavaOpts | "" | Parameters to be added to ES_JAVA_OPTS environment variable for data |
elasticsearch.data.exposeHttp | false | Expose http port 9200 on data Pods for monitoring, etc |
elasticsearch.data.replicas | 2 | Data node replicas (statefulset) |
elasticsearch.data.resources | {} - cpu limit must be an integer | Data node resources requests & limits |
elasticsearch.data.priorityClassName | nil | Data priorityClass |
elasticsearch.data.heapSize | 1536m | Data node heap size |
elasticsearch.data.hooks.drain.enabled | true | Data nodes: Enable drain pre-stop and post-start hook |
elasticsearch.data.persistence.enabled | false | Data persistent enabled/disabled |
elasticsearch.data.persistence.name | data | Data statefulset PVC template name |
elasticsearch.data.persistence.size | 30Gi | Data persistent volume size |
elasticsearch.data.persistence.storageClass | nil | Data persistent volume Class |
elasticsearch.data.persistence.accessMode | ReadWriteOnce | Data persistent Access Mode |
elasticsearch.data.readinessProbe | see values.yaml for defaults | Readiness probes for data-containers |
elasticsearch.data.podAnnotations | {} | Data StatefulSet annotations |
elasticsearch.data.nodeSelector | {} | Node labels for data pod assignment |
elasticsearch.data.tolerations | [] | Data tolerations |
elasticsearch.data.terminationGracePeriodSeconds | 3600 | Data termination grace period (seconds) |
elasticsearch.data.antiAffinity | soft | Data anti-affinity policy |
elasticsearch.data.nodeAffinity | {} | Data node affinity policy |
elasticsearch.data.podManagementPolicy | OrderedReady | Data pod creation strategy |
elasticsearch.data.updateStrategy | {type: "onDelete"} | Data node update strategy policy |
Specify each parameter using the --set key=value[,key=value]
argument to helm install
. For example,
$ helm install myrelease skywalking --set nameOverride=newSkywalking
Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the chart. For example,
$ helm install my-release skywalking -f values.yaml
Tip: You can use the default values.yaml
Roles and RoleBindings resources will be created automatically for OAP
.
Tip: You can refer to the default
oap-role.yaml
file in templates to customize your own.
If your cluster allows automatic create/retrieve of TLS certificates (e.g. kube-lego), please refer to the documentation for that mechanism.
To manually configure TLS, first create/retrieve a key & certificate pair for the address(skywalking ui) you wish to protect. Then create a TLS secret in the namespace:
kubectl create secret tls skywalking-tls --cert=path/to/tls.cert --key=path/to/tls.key
Include the secret's name, along with the desired hostnames, in the skywalking-ui Ingress TLS section of your custom values.yaml
file:
ui: ingress: ## If true, Skywalking ui server Ingress will be created ## enabled: true ## Skywalking ui server Ingress hostnames ## Must be provided if Ingress is enabled ## hosts: - skywalking.domain.com ## Skywalking ui server Ingress TLS configuration ## Secrets must be manually created in the namespace ## tls: - secretName: skywalking-tls hosts: - skywalking.domain.com
Envoy ALS(access log service) provides fully logs about RPC routed, including HTTP and TCP.
If you want to open envoy ALS, you can do this by modifying values.yaml.
oap: envoy: als: enabled: true
When envoy als ,will give ServiceAccount clusterrole permission. More envoy als ,please refer to als_setting