You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+19-28Lines changed: 19 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,11 +16,11 @@ To remove these obstacles, [eks-node-diagnostic](https://github.com/guessi/eks-n
16
16
17
17
## 🔢 Prerequisites
18
18
19
-
* An existing [Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html) cluster with the node monitoring agent.
19
+
* An existing [Amazon EKS](https://docs.aws.amazon.com/eks/latest/userguide/what-is-eks.html)AutoMode cluster or a cluster with the [Node Monitoring Agent](https://docs.aws.amazon.com/eks/latest/userguide/node-health-nma.html) installed.
20
20
* An existing [kubeconfig](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html).
21
21
*[Grant IAM users and roles access to Kubernetes APIs](https://docs.aws.amazon.com/eks/latest/userguide/grant-k8s-access.html).
22
-
* An existing [Amazon S3 bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) for storing node logs generated by `NodeDiagnostic`. (only required for `destinationType: s3`)
23
-
* An IAM Role/User with [s3:PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) permission (to generate presigned S3 url). (only required for `destinationType: s3`)
22
+
*(Only required for `destinationType: s3`) An existing [Amazon S3 bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html) for storing node logs generated by `NodeDiagnostic`.
23
+
*(Only required for `destinationType: s3`) An IAM Role/User with [s3:PutObject](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) permission (to generate presigned S3 url).
24
24
25
25
## 👀 Key differences with [official guidance](https://docs.aws.amazon.com/eks/latest/userguide/auto-get-logs.html)
26
26
@@ -30,48 +30,39 @@ To remove these obstacles, [eks-node-diagnostic](https://github.com/guessi/eks-n
30
30
31
31
## 🚀 Quick start
32
32
33
-
Make sure you are running with v1.2.0 (or newer version)
33
+
Get `config.yaml` ready, you may find examples at [examples/](./examples/) folder.
34
34
35
-
```bash
36
-
eks-node-diagnostic version
37
-
```
38
-
39
-
Get `config.yaml` ready
35
+
Execute
40
36
41
37
```bash
42
-
cat config.yaml
43
-
---
44
-
region: us-east-1
45
-
expiredSeconds: 300 # optional, default: 300
46
-
timeout: 30 # optional, default: 30 (in seconds)
47
-
destinationType: s3 # optional, default: s3, "s3" or "node"
48
-
bucketName: node-diagnostic-EXAMPLE
49
-
50
-
# the node name should match the NAME from `kubectl get nodes`
51
-
nodes:
52
-
- i-EXAMPLE1111111111
53
-
- i-EXAMPLE2222222222
54
-
- i-EXAMPLE3333333333
55
-
...
38
+
eks-node-diagnostic [--config-file config.yaml]
56
39
```
57
40
58
-
Execute
59
-
60
41
```bash
61
-
eks-node-diagnostic
62
42
nodediagnostic.eks.amazonaws.com/i-EXAMPLE1111111111 created
63
43
nodediagnostic.eks.amazonaws.com/i-EXAMPLE2222222222 created
64
44
nodediagnostic.eks.amazonaws.com/i-EXAMPLE3333333333 created
65
45
...
66
46
```
67
47
48
+
Check
49
+
50
+
```bash
51
+
kubectl describe nodediagnostics
52
+
```
53
+
68
54
## :accessibility: FAQ
69
55
70
-
Where can I find log archive generated by `NodeDiagnostic`?
56
+
Where can I find log archive generated by `NodeDiagnostic` when `destinationType` set as `s3`?
71
57
72
58
* Log archive generated by `NodeDiagnostic` would be placed at path below,
73
59
74
-
> `s3://{{ BUCKET }}/node-diagnostic/log__{{ REGION }}__{{ NODE }}__{{ TIMESTAMP }}.tar.gz`
60
+
> `s3://{{ BUCKET }}/node-diagnostic/log__{{ REGION }}__{{ NODE_NAME }}__{{ TIMESTAMP }}.tar.gz`
61
+
62
+
Where can I find log archive generated by `NodeDiagnostic` when `destinationType` set as `node`?
63
+
64
+
* Generic Linux: Log should be available at `/var/log/support/${NODE_NAME}$-logs.tar.gz`
65
+
* Bottlerocket: Log should be available at `/.bottlerocket/support/${NODE_NAME}$-logs.tar.gz`
75
66
76
67
How do I report an issue or submit a feature request?
0 commit comments