|
1 | 1 | # LogDNA Kubernetes Agent
|
2 | 2 |
|
3 |
| -[LogDNA](https://logdna.com) - Easy, beautiful logging in the cloud. |
| 3 | +<a href="https://logdna.com" target="_blank">LogDNA</a> - Easy, beautiful logging in the cloud. |
4 | 4 |
|
5 | 5 | ## Introduction
|
6 | 6 |
|
7 | 7 | This chart deploys LogDNA collector agents to all nodes in your cluster. Logs will ship from all containers.
|
8 | 8 | We extract pertinent Kubernetes metadata: pod name, container name, container id, namespace, labels, and annotations.
|
9 |
| -View your logs at https://app.logdna.com or live tail using our [CLI](https://github.com/logdna/logdna-cli). |
10 |
| - |
11 |
| -## Prerequisites |
12 |
| - |
13 |
| -- Kubernetes 1.11.10+ |
14 |
| - |
15 |
| -## Installing the Chart |
16 |
| - |
17 |
| -Please follow directions from https://app.logdna.com/pages/add-source to obtain your LogDNA Ingestion Key. |
18 |
| - |
19 |
| -To install the chart with the release name `my-release`: |
20 |
| - |
21 |
| -```bash |
22 |
| -$ helm repo add logdna https://assets.logdna.com/charts |
23 |
| -$ helm install --set logdna.key=LOGDNA_INGESTION_KEY my-release logdna/agent |
24 |
| -``` |
25 |
| - |
26 |
| -You should see logs in https://app.logdna.com in a few seconds. |
27 |
| - |
28 |
| -### Tags support: |
29 |
| -```bash |
30 |
| -$ helm install --set logdna.key=LOGDNA_INGESTION_KEY,logdna.tags=production my-release logdna/agent |
31 |
| -``` |
32 |
| - |
33 |
| -## Uninstalling the Chart |
34 |
| - |
35 |
| -To uninstall/delete the `my-release` deployment: |
36 |
| - |
37 |
| -```bash |
38 |
| -$ helm uninstall my-release |
39 |
| -``` |
40 |
| - |
41 |
| -The command removes all the Kubernetes components associated with the chart and deletes the release. |
42 |
| - |
43 |
| -## Configuration |
44 |
| - |
45 |
| -The following tables lists the configurable parameters of the LogDNA Agent chart and their default values. |
46 |
| - |
47 |
| -Parameter | Description | Default |
48 |
| ---- | --- | --- |
49 |
| -`daemonset.tolerations` | List of node taints to tolerate | `[]` |
50 |
| -`daemonset.updateStrategy` | Optionally set an update strategy on the daemonset. | None |
51 |
| -`image.pullPolicy` | Image pull policy | `IfNotPresent` |
52 |
| -`logdna.key` | LogDNA Ingestion Key (Required) | None |
53 |
| -`logdna.tags` | Optional tags such as `production` | None |
54 |
| -`priorityClassName` | (Optional) Set a PriorityClass on the Daemonset | `""` |
55 |
| -`resources.limits.memory` | Memory resource limits |500Mi |
56 |
| -`updateOnSecretChange` | Optionally set annotation on daemonset to cause deploy when secret changes | None |
57 |
| -`extraEnv` | Additional environment variables | `{}` |
58 |
| -`extraVolumeMounts` | Additional Volume mounts | `[]` |
59 |
| -`extraVolumes` | Additional Volumes | `[]` |
60 |
| -`serviceAccount.create` | Whether to create a service account for this release | `true` |
61 |
| -`serviceAccount.name` | The name of the service account. Defaults to `logdna-agent` unless `serviceAccount.create=false` in which case it defaults to `default` | None |
62 |
| - |
63 |
| -Specify each parameter using the `--set key=value[,key=value]` argument to `helm install`. For example, |
64 |
| - |
65 |
| -```bash |
66 |
| -$ helm install --set logdna.key=LOGDNA_INGESTION_KEY,logdna.tags=production my-release logdna/agent |
67 |
| -``` |
68 |
| - |
69 |
| -Alternatively, a YAML file that specifies the values for the above parameters can be provided while installing the |
70 |
| -chart. For example, |
71 |
| - |
72 |
| -```bash |
73 |
| -$ helm install -f values.yaml my-release logdna/agent |
74 |
| -``` |
| 9 | +View your logs at <a href="https://app.logdna.com" target="_blank">https://app.logdna.com</a> or live tail using the <a href="https://github.com/logdna/logdna-cli" target="_blank">LogDNA CLI</a>. |
0 commit comments