Skip to content

Commit 4c3d631

Browse files
committed
Update README.md and examples
1 parent 5e277a6 commit 4c3d631

File tree

4 files changed

+39
-31
lines changed

4 files changed

+39
-31
lines changed

README.md

Lines changed: 19 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -16,11 +16,11 @@ To remove these obstacles, [eks-node-diagnostic](https://github.com/guessi/eks-n
1616

1717
## 🔢 Prerequisites
1818

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.
2020
* An existing [kubeconfig](https://docs.aws.amazon.com/eks/latest/userguide/create-kubeconfig.html).
2121
* [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).
2424

2525
## 👀 Key differences with [official guidance](https://docs.aws.amazon.com/eks/latest/userguide/auto-get-logs.html)
2626

@@ -30,48 +30,39 @@ To remove these obstacles, [eks-node-diagnostic](https://github.com/guessi/eks-n
3030

3131
## 🚀 Quick start
3232

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.
3434

35-
```bash
36-
eks-node-diagnostic version
37-
```
38-
39-
Get `config.yaml` ready
35+
Execute
4036

4137
```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]
5639
```
5740

58-
Execute
59-
6041
```bash
61-
eks-node-diagnostic
6242
nodediagnostic.eks.amazonaws.com/i-EXAMPLE1111111111 created
6343
nodediagnostic.eks.amazonaws.com/i-EXAMPLE2222222222 created
6444
nodediagnostic.eks.amazonaws.com/i-EXAMPLE3333333333 created
6545
...
6646
```
6747

48+
Check
49+
50+
```bash
51+
kubectl describe nodediagnostics
52+
```
53+
6854
## :accessibility: FAQ
6955

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`?
7157

7258
* Log archive generated by `NodeDiagnostic` would be placed at path below,
7359

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`
7566

7667
How do I report an issue or submit a feature request?
7768

config.yaml renamed to examples/config-full.yaml

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,5 @@ bucketName: node-diagnostic-EXAMPLE
1919
# $ kubectl get nodes -o jsonpath='{range .items[*]}{"- "}{.metadata.name}{"\n"}{end}'
2020
nodes: []
2121
# nodes:
22-
# - i-EXAMPLE1111111111
23-
# - i-EXAMPLE2222222222
24-
# - i-EXAMPLE3333333333
22+
# - ip-192-168-100-200.ec2.internal
23+
# - i-EXAMPLE1111111111

examples/config-node.yaml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
region: us-east-1
3+
4+
destinationType: node
5+
6+
nodes:
7+
- ip-192-168-100-200.ec2.internal
8+
- i-EXAMPLE1111111111

examples/config-s3.yaml

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
---
2+
region: us-east-1
3+
4+
destinationType: s3
5+
6+
bucketName: node-diagnostic-EXAMPLE
7+
8+
nodes:
9+
- ip-192-168-100-200.ec2.internal
10+
- i-EXAMPLE1111111111

0 commit comments

Comments
 (0)