이 글에서는 디스호스트 서비스의 디스호스트 호스팅 봇만 검색 옵션이 어떤 역할을 하는지, 왜 필요한지와 해당 옵션에 내 봇을 포함시키려면 어떤 절차를 따르면 되는지 정리한다. 디스코드 봇을 디스호스트에서 호스팅하거나 목록에 표시하려는 운영자에게 실무적으로 도움이 되도록 작성했다.
증상
검색 필터에서 디스호스트 호스팅 봇만 옵션을 활성화하면, 일반 검색 결과에서 일부 봇들이 제외되고 디스호스트 인프라에서 호스팅 중인 봇들만 표시된다. 이 옵션을 켰을 때 내 봇이 목록에 보이지 않으면, 해당 봇이 디스호스트에서 호스팅 중이 아닌 상태거나 목록에 호스팅 정보가 등록되지 않은 상태일 가능성이 있다.
원인
이 옵션은 플랫폼 쪽에서 각 봇의 호스팅 정보(호스팅 제공자) 를 기준으로 필터링하기 위해 존재한다. 즉, 봇이 실제로 디스호스트 인프라에서 실행 중이어야 하고, 봇 목록의 메타데이터에 호스팅 제공자로 디스호스트가 표기되어 있어야 필터 대상에 포함된다.
내 봇이 디스호스트에서 실행되더라도 목록에 해당 정보가 누락되어 있거나, 호스팅 정보가 정확히 일치하지 않으면 필터에 잡히지 않는다. 또한 플랫폼 내부 동기화 지연이나 캐시로 인해 변경이 즉시 반영되지 않을 수 있다.
해결 방법
1단계: 디스호스트에서 봇이 실제로 실행 중인지 확인
- 디스호스트 대시보드에서 해당 봇의 인스턴스 상태(실행 중, 중지 등)를 확인한다.
- 프로세스가 정상 동작하고 있음을 로그나 대시보드에서 확인한다.
2단계: 봇 목록(또는 등록 정보)에 호스팅 제공자 정보 등록
- 봇 등록 페이지나 메타데이터 설정에서 호스팅 제공자(provider) 항목이 있는지 확인하고, 값으로
디스호스트를 선택하거나 입력한다. - 플랫폼에서 공개하는 봇 메타데이터 형식이 있다면 그 규격에 맞춰 호스팅 정보를 포함시킨다.
예시 메타데이터(참고용)
{
"bot_id": "123456789012345678",
"name": "MyDiscordBot",
"hosting": {
"provider": "dishost",
"region": "kr",
"instance_id": "dishost-xyz-01"
}
}
3단계: 동기화 및 캐시 확인
- 메타데이터를 수정한 뒤에는 플랫폼의 반영 시간을 고려하여 잠시 기다린다.
- 즉시 반영되지 않는 경우 캐시 만료 시간(예: 몇 분 ~ 몇 시간)을 확인한다.
4단계: 그래도 목록에 표시되지 않으면
- 호스팅 정보가 정확히 입력되었는지 다시 한 번 점검한다(오타, 형식 오류 등).
- 플랫폼에서 요구하는 추가 검증 절차(예: 소유권 증명, API 키 연결 등)가 있는지 확인한다.
- 필요하면 디스호스트 지원팀에 상황을 설명하고 호스팅 표시가 누락된 사례를 요청한다.
마무리
디스호스트 호스팅 봇만 옵션은 디스호스트 인프라에서 실행 중인 디스코드 봇을 쉽게 찾아보도록 돕는 필터다. 내 봇을 해당 필터에 포함시키려면 실제 호스팅 여부와 목록의 호스팅 메타데이터를 정확히 설정하면 된다.