SERVICE-2611 k8s 2.16.0 업데이트 내용 추가

Author: bhinsuu

common-items/_metric-warning-notice-new.mdx

@@ -76,6 +76,14 @@
 
 3. <Cmdname sid="TTL07364" className="uitext" />: 이벤트 이름 및 메시지, 수신 대상을 설정합니다.
 
+
+#### 메트릭스 검색하기 {#search-for-metrics}
+
+이벤트 설정 시, 메트릭스 정보를 쉽게 검색하고 활용할 수 있습니다. 
+
+<Cmdname sid="select_category" className="uitext" />, <Cmdname sid="TTL07365" className="uitext" />, <Cmdname sid="TTL07363" /> 항목에서 메트릭스 검색기로 메트릭스를 검색하고 메트릭스 정보를 확인하세요. 선택한 메트릭스가 화면에 적용됩니다.
+
+
 ### <Cmdname sid="TTL07362" /> {#TTL07362}
 
 알림을 받기 위한 이벤트 조건을 설정할 수 있습니다.

common-items/_set-receive-event-3rdparty.mdx

@@ -218,25 +218,25 @@ Slack, Telegram, Teams, Jandi, Webhook 등의 외부 애플리케이션을 통
 
 <summary>Webhook JSON</summary>
 
-1. 알림을 받을 Webhook을 등록하세요. 등록한 URL에 POST Method로 알림 데이터가 JSON 형태로 전송됩니다.
+1. 알림을 받을 Webhook을 등록하세요. 등록한 URL에 POST Method로 알림 데이터가 JSON 형태로 전송됩니다. JSON 내에 포함 시킬 수 있는 대체 변수에 대해선 **사용 가능 변수** 부분을 참고하세요.
 
     ```json
     {
-        "pcode": 1234,
-        "projectName": "Sample project",
-        "time": 1577840400000,
-        "oid": 1234567890,
-        "oname": "WAS-01", // Optional
-        "title": "Alert Title",
-        "message": "Sample warning message",
-        "level": "Warning",
-        "status": "on",
-        "metricName": "cpu", // Optional
-        "metricValue": "99.99", // Optional
-        "metricThreshold": "90", // Optional
-        "uuid": "ba5db108b788475c95195***********",
-        "okind": "WAS-okind-01", // Optional
-        "onode": "WAS-onode-01", // Optional
+        "pcode": "${pcode}",
+        "projectName": "${projectName}",
+        "time": "${time}",
+        "oid": "${oid}",
+        "oname": "${oname}",
+        "title": "${title}",
+        "message": "${message}",
+        "level": "${level}",
+        "status": "${status}",
+        "metricName": "${metricName}",
+        "metricValue": "${metricValue}",
+        "metricThreshold": "${metricThreshold}",
+        "uuid": "${uuid}",
+        "okind": "${okind}",
+        "onode": "${onode}"
     }
     ```
 

kubernetes/agent-troubleshooting.mdx

@@ -136,8 +136,31 @@ helm install whatap-kube-agent whatap/kube --create-namespace --namespace <names
 
 1. <Cmdname sid="side_management" className="uitext" /> > <Cmdname sid="side_kubernetesAgentList" className="uitext" /> 메뉴에서 각 모니터링 에이전트에서 발생하는 로그를 확인하세요.
 
-</div>
+### DockerHub 이미지 pull limit으로 에이전트가 정상적으로 설치되지 않는 경우 {#troubleshooting-pull-limit}
+
+여러 노드에서 동시에 이미지를 pull할 경우 아래와 같은 오류가 발생하며 설치에 실패할 수 있습니다. 문제가 발생한 경우 아래 명령어로 yaml에 이미지를 변경해 재설치가 필요합니다.
 
+#### 에러 조회
+
+```yaml
+kubectl describe pod/<와탭 k8s 에이전트 파드명> -n whatap-monitoring
+```
+
+#### 조회 결과
+
+```yaml
+>> Failed to pull image "whatap/kube_mon:latest": rpc error: code = Unknown desc = toomanyrequests: You have reached your pull rate limit. Please try again later or log in to increase your rate limit.
+```
+
+이 경우, `yaml` 파일 내 DockerHub 이미지를 public.ecr.aws 레포로 변경한 후 재설치가 필요합니다.
+
+* 에이전트 설치 화면에서 기본 설치용 yaml을 다운로드한 경우 아래 명령어를 사용해 이미지를 변경할 수 있습니다. 명령어 수행 시 yaml에 있는 기존 dockerHub 이미지가 [public.ecr.aws](http://public.ecr.aws) 리포지토리 이미지로 대체됩니다.
+
+  ```yaml
+  sed -i 's|image: "whatap/kube_mon|image: "public.ecr.aws/whatap/kube_mon|g' kube_agent.yaml
+  ```
+
+</div>
 
 ## 애플리케이션 연동 문제 해결{#troubleshooting-k8s-application} 
 

kubernetes/install-master-node-agent-v2.mdx

@@ -37,27 +37,26 @@ EKS Fargate는 지원 예정입니다.
 
 ### 와탭 쿠버네티스 에이전트 이미지 리포지토리 추가 지원
 
-와탭 쿠버네티스 에이전트는 기존 DockerHub 외에 Public ECR을 추가로 지원합니다. 사용 환경에 따라 다음 두 이미지 리포지토리 중 하나를 선택하여 설치할 수 있습니다.
+와탭 쿠버네티스 에이전트는 기존 DockerHub 외에 Public ECR을 추가로 지원합니다. 사용 환경에 따라 두 이미지 리포지토리 중 하나를 선택하여 설치할 수 있습니다.
 
 #### Public ECR
 
 * 리포지토리 <code class='my'>추천</code>: `public.ecr.aws/whatap/kube_mon`
 
-AWS ECR은 이미지 다운로드에 대한 제한이 없으므로, 빈번한 업데이트나 대규모 노드 배포 환경에서 안정적으로 사용할 수 있습니다.
+ECR은 pull 제한 정책에 영향을 받지 않으므로, 빈번한 업데이트나 대규모 배포 환경에서 안정적으로 사용할 수 있어 권장합니다.
 
 #### DockerHub
 
 * 리포지토리: `whatap/kube_mon`
 
-DockerHub는 인증되지 않은 클라이언트의 경우 pull 제한이 발생할 수 있습니다. 노드 수가 많거나 동시에 pull 요청이 발생하는 경우 rate limit 에 걸릴 수 있습니다. 다음 [DockerHub 정책 안내](https://docs.docker.com/docker-hub/usage/)를 참고해 주세요.
+DockerHub는 인증되지 않은 클라이언트에 대해 pull 제한(policy)이 적용될 수 있습니다. 노드 수가 많거나 동시에 pull 요청이 발생하는 경우 rate limit에 걸려 설치가 실패할 가능성이 높습니다. 자세한 내용은 [DockerHub 정책 안내](https://docs.docker.com/docker-hub/usage/) 공식 문서를 참고해 주세요.
 
-:::note 
+:::caution 
 
-pull 제한이 발생한 경우 다음 문서(개별 문서 또는 안내 추가)를 참고하세요.
+pull 제한이 발생한 경우 [다음 문서](agent-troubleshooting#troubleshooting-pull-limit)를 참고하세요. 
 
 :::
 
-
 ## 추가 기능 적용 {#additional-features}
 
 와탭 쿠버네티스 모니터링은 다양한 추가 기능을 제공합니다. 
@@ -174,15 +173,14 @@ clusterrole:
 
 :::
 
-
-
 ## 설치 파일 다운로드 
 
 설치 파일 다운로드 전 사용자 쿠버네티스 환경에 알맞은 항목이 선택되었는지 확인하세요. 선택 항목 확인 후 ***설치 파일 다운로드*** 버튼을 클릭해 설치에 필요한 기본 설정 파일(*values.yaml*)을 다운로드하세요. 
 
 <ImgLang img='k8s-install-master-node-download.png' desc='설치 파일 다운로드'/>
 
-다운로드 후 화면 오른쪽 아래의 ***다음*** 버튼을 클릭하거나 ***실행 명령어 입력*** 탭을 선택해 다음 단계로 이동하세요. 
+다운로드 후 화면 오른쪽 아래의 ***다음*** 버튼을 클릭하거나 ***실행 명령어 입력*** 탭을 선택해 다음 단계로 이동하세요.
+
 
 ## 실행 명령어 입력 
 

kubernetes/resource-node-list.mdx

@@ -30,7 +30,9 @@ toc_max_heading_level: 2
 
 * 전체 노드 개수 및 상태별 노드 개수를 확인할 수 있습니다.
 
-* 원하는 컬럼 선택 시 해당 컬럼 기준으로 <Cmdname sid="node_list" className="uitext" />을 정렬해 조회할 수 있습니다. 
+* 원하는 컬럼 선택 시 해당 컬럼 기준으로 <Cmdname sid="node_list" className="uitext" />을 정렬해 조회할 수 있습니다.
+
+* <Cmdname sid="node_list" className="uitext" /> 칼럼 좌측 확장 버튼을 클릭하면 디스크 정보를 확인할 수 있습니다.
 
 
 ## 메트릭 정보