> For the complete documentation index, see [llms.txt](https://cocktailcloud.gitbook.io/cocktail-cloud-online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cocktailcloud.gitbook.io/cocktail-cloud-online/log-service/troubleshooting.md).

# Troubleshooting

## Cocktail Log Service

### 설치시 로그서비스의 마스터/데이터 노드들이 정상적으로 시작하지 않을때 <a href="#logservice-install-error" id="logservice-install-error"></a>

<details>

<summary>ERROR: [1] bootstrap checks failed [1]: max virtual memory areas vm.max_map_count [65530] is too low, increase to at least [262144]</summary>

다음과 같은 오류는 bootstrap을 체크하는 과정에서 max\_map\_count값이 262,144이하면 안정성을 위해 실행되지 않도록 되어있기 때문입니다.

따라서 해당 노드에 접속하여 다음과 같은 명령어 입력 후 재시작

```sh
/$ vi /etc/sysctl.conf

# 작성
vm.max_map_count=262144

# 적용
/$ sysctl -p
```

</details>

### 로그 서비스 설치 시 PVC 생성에서 멈추어 있는 경우

<details>

<summary>pod had unbound immediate PersistentVolumeClaims 이벤트에서 멈춤</summary>

쿠버네티스가 PVC를 생성 하지 못하여 설치가 진행되지 않는 경우 입니다. 설치 옵션에서 persistence 영역의 storageClass 이름이 정확한지 확인 해 주세요. 이름을 맞게 변경하고 재설치를 수행합니다.

</details>

### cocktail-logs-api 의 CrashLoopBackOff 오류

<details>

<summary>config-watcher 컨테이너의 로그 <code>config apiUrl is empty</code></summary>

칵테일 환경 변수 누락입니다. 칵테일에 Gateway 설치 여부 확인 후 칵테일 **관리자에게 Cocktail Gateway URL 환경변수 등록 요청**을 해야 합니다.&#x20;

</details>

## Cocktail Log Agent

### log-agent 파드의 초기화 실패 메시지 (Init: Signal: null)

<details>

<summary>Init:Signal:null 상태</summary>

설치된 애드온 인스턴스의 상태가 <mark style="color:orange;">**Init:Signal:null**</mark> 인 경우, 칵테일 환경 변수 선언이 정상적이지 않아 실패하는 경우입니다. 파드의 초기화 컨테이너 로그와 함께 칵테일 관리자에게 환경 변수 설정을 요청 합니다.&#x20;

```bash
# 파드의 초기화 컨테이너(config-pull)의 로그를 출력 합니다. 
kubectl -n cocktail-addon logs [POD FULL NAME] -c config-pull
```

</details>

## Application Log&#x20;

### fluent-bit 컨테이너가 제대로 작동하지 않을때 <a href="#fluent-bit-errer" id="fluent-bit-errer"></a>

<details>

<summary>[error] could not open configuration file, aborting.</summary>

해당 로그는 fluent-bit 설정파일 마운트 정보가 다르기때문에 일어난 오류입니다.

설정파일 이름과 위치를 잘 확인하시고 배포해주시길 바랍니다.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cocktailcloud.gitbook.io/cocktail-cloud-online/log-service/troubleshooting.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.