Troubleshooting

이 가이드를 사용하여 CDNetworks Media Acceleration Live Broadcast의 일반적인 스트림 인제스트 및 재생 문제를 진단할 수 있습니다. 문제와 가장 잘 일치하는 증상부터 시작하여, 순서대로 점검을 완료하고 요청된 세부 정보를 수집한 후 CDNetworks 지원팀에 문의하시기 바랍니다.

Table of Contents

• 스트림 인제스트 문제
• 스트림을 게시할 수 없음
• 1. DNS 및 CNAME 구성 확인
• 2. 인코더 설정 확인
• 3. 오디오 및 비디오 포맷 확인
• 4. 중복 활성 스트림 확인
• 5. URL 인증 확인
• 6. 스트림 송출 차단 여부 확인
• 7. 퍼블리셔의 네트워크를 확인하세요
• 재생 문제
• 스트림을 재생할 수 없거나 404가 반환됨
• 1. 재생 URL 확인
• 2. DNS 및 CNAME 구성 확인
• 3. 송출(ingest)이 활성화되어 있는지 확인
• 4. 다른 플레이어로 테스트하기
• 5. 시청자의 네트워크 확인
• 재생이 자주 끊기거나 버퍼링이 발생합니다
• 화면이 흐릿하게 보임
• 재생이 예기치 않게 중지됨
• RTMP 및 HTTP-FLV는 작동하지만 HLS는 실패합니다
• HLS는 비디오만 있고 오디오는 없음
• 수집해야 할 정보

스트림 인제스트 문제

스트림을 게시할 수 없음

1. DNS 및 CNAME 구성 확인

인제스트 Domain을 추가하면, CDNetworks에서 CNAME 대상이 할당됩니다. DNS 공급자를 통해 해당 CNAME 레코드를 생성해 주십시오.

• DNS 조회 도구를 사용해 인제스트 Domain이 CDNetworks에서 할당된 CNAME 대상으로 정상 해석되는지 확인하십시오.
• Domain이 해석되지 않거나 다른 곳을 가리키는 경우, DNS 레코드를 수정하고 변경 사항이 전파될 때까지 기다리십시오.

2. 인코더 설정 확인

인코더에 올바른 서버 URL과 스트림 키가 입력되어 있는지 확인하십시오. OBS Studio 및 유사한 인코더에서는 다음과 같이 하실 수 있습니다:

• Server에는 인제스트 Domain과 AppName이 포함되어 있습니다.
• Stream Key에는 StreamName 및 쿼리 문자열 파라미터가 포함됩니다.
• URL 인증이 활성화된 경우, 모든 필수 인증 파라미터를 포함해야 합니다. 예를 들어, 타임스탬프 인증에는 wsTime과 wsSecret이 필요할 수 있습니다.

가능하다면 다른 인코더로 테스트하여 문제가 원래 인코더나 해당 설정에 국한된 것인지 확인해 주십시오.

3. 오디오 및 비디오 포맷 확인

H.264 비디오와 AAC 오디오는 라이브 스트리밍에 일반적으로 사용됩니다. FFmpeg를 사용하여 스트림을 검사하십시오:

ffmpeg -i "rtmp://<ingest-domain>/<app-name>/<stream-name>"

플레이스홀더를 Ingest Domain, AppName, StreamName으로 바꿔주세요. 출력 결과에서 감지된 코덱과 연결, 인증 또는 디코딩 오류가 있는지 확인하세요.

4. 중복 활성 스트림 확인

두 개의 퍼블리셔는 동일한 AppName 내에서 같은 StreamName으로 동시에 송출할 수 없습니다. 인코더에서 Server error: Failed to publish 오류가 표시되면, 다른 인코더나 프로세스가 이미 동일한 스트림을 송출 중이 아닌지 확인한 후 다시 시도하세요.

5. URL 인증 확인

URL 인증이 활성화된 경우, Ingest URL에는 유효하고 만료되지 않은 파라미터가 포함되어야 합니다. 파라미터가 누락되었거나, 철자가 잘못되었거나, 유효하지 않거나, 만료된 경우에는 I/O 오류로 인해 송출이 실패할 수 있습니다. wsTime 및 wsSecret 등의 값을 확인한 후, 필요하다면 새로 인증된 URL을 생성하시기 바랍니다.

6. 스트림 송출 차단 여부 확인

콘솔의 스트림 차단 작업 목록을 활용해 해당 스트림 또는 송출 IP 주소가 차단되어 있는지 확인하세요. 스트림을 복구해야 하는 경우, 조직의 변경 절차를 따르거나 승인된 관리자에게 문의하시기 바랍니다.

7. 퍼블리셔의 네트워크를 확인하세요

• DNS 조회 도구를 사용하여 Ingest Domain이 올바르게 해석되는지 확인하세요.
• 게시자와 인제스트 Domain 간의 패킷 손실 또는 불안정한 지연이 있는지 확인하세요.
• RTMP를 사용할 때, TCP 포트 1935에서 인제스트 Domain으로의 연결을 테스트하세요.
• 게시자는 구성된 비트레이트에 대해 충분하고 안정적인 업스트림 대역폭을 보유하고 있는지 확인하세요.

연결 테스트에 실패하면, 로컬 방화벽, 프록시, 라우팅 및 ISP 제한을 확인하세요.

재생 문제

스트림을 재생할 수 없거나 404가 반환됨

1. 재생 URL 확인

재생 URL은 일반적으로 Delivery Domain, AppName 및 StreamName을 포함합니다. 경로와 확장자는 프로토콜에 따라 달라집니다. 예시:

rtmp://play.example.com/app/stream
https://play.example.com/app/stream.flv
https://play.example.com/app/stream/playlist.m3u8

도메인, AppName, StreamName, 프로토콜, 경로, 확장자, 대소문자를 확인하세요. 인증이 활성화된 경우, 모든 필수 파라미터가 존재하는지, 만료되지 않았는지도 추가로 확인해 주세요.

2. DNS 및 CNAME 구성 확인

DNS 조회 도구를 사용하여 재생 도메인이 CDNetworks에서 지정한 CNAME 대상으로 정확히 resolving되는지 확인하세요. resolving되지 않는 경우, DNS 레코드를 수정하거나 DNS 관리자에게 문의하시기 바랍니다.

3. 송출(ingest)이 활성화되어 있는지 확인

소스 스트림이 송출되지 않으면 재생이 실패합니다. 인코더가 연결되어 데이터를 전송 중인지 확인한 다음, 스트림을 송출할 수 없음에서 안내하는 점검을 완료해 주세요.

4. 다른 플레이어로 테스트하기

재생 프로토콜을 지원하는 다른 플레이어에서 시도해보세요. 만약 스트림이 다른 플레이어에서 정상 작동한다면, 기존 플레이어의 프로토콜 지원, 미디어 코덱 지원 및 설정을 검토하시기 바랍니다.

브라우저 기반 재생의 경우, 브라우저 콘솔에서 교차 출처(CORS) 오류가 있는지 확인하세요. 플레이어 페이지와 스트림이 서로 다른 Origin을 사용하는 경우, 재생 응답에 필수 CORS 헤더가 포함되어야 합니다.

5. 시청자의 네트워크 확인

다른 기기 또는 네트워크에서 재생을 비교해보세요. 한 명의 시청자만 영향을 받는 경우, 해당 시청자의 연결 상태, 방화벽, 프록시, 브라우저 및 플레이어 환경을 조사해보세요.

재생이 자주 끊기거나 버퍼링이 발생합니다

송출부터 재생까지 스트림을 확인하세요:

1. 퍼블리셔의 업스트림 연결이 안정적이며, 설정된 비트레이트를 지속적으로 유지할 수 있는지 확인하세요.
2. 인코더의 CPU 및 하드웨어 사용률을 확인하세요. 인코더가 과부하 상태라면, 비트레이트, 해상도 또는 프레임 레이트를 낮춰서 테스트해보세요.
3. 설정된 프레임 레이트가 콘텐츠에 적합한지 확인하세요. 프레임 레이트가 매우 낮으면 끊기는 현상이 발생할 수 있습니다.
4. 다른 기기, 플레이어, 네트워크에서 재생을 비교해보세요.
5. 플레이어의 버퍼 설정을 확인하세요. 버퍼 크기를 늘리면 복원력이 개선될 수 있지만, 재생 지연이 증가할 수 있습니다.

화면이 흐릿하게 보임

1. 송출 전에 소스가 선명하게 보이는지 확인하세요.
2. 예기치 않은 비트레이트, 프레임레이트, 해상도 또는 스트림 오류가 있는지 인제스트 분석을 검토하세요.
3. 인코더가 하드웨어나 네트워크 제한으로 인해 비트레이트나 해상도를 예기치 않게 낮추지 않는지 확인하세요.
4. 송출 중 스트림 메타데이터가 변경되는지 확인하세요. 예기치 않은 변경은 다운스트림 처리에 영향을 줄 수 있습니다.
5. 다른 플레이어로 테스트하세요. 지원되는 경우, 소프트웨어 디코딩과 하드웨어 디코딩을 비교해 보세요.

재생이 예기치 않게 중지됨

1. 인제스트가 같은 시간에 중지되었는지 확인하십시오. 그렇다면 먼저 퍼블리셔와 해당 네트워크를 점검하십시오.
2. 중단이 한 명의 시청자, 하나의 네트워크 또는 여러 지역의 여러 시청자에게 영향을 미쳤는지 확인하십시오.
3. 다른 플레이어, 기기 또는 네트워크에서 테스트하십시오.
4. 수집할 정보에 나열된 사고 세부 정보를 기록하십시오.

RTMP 및 HTTP-FLV는 작동하지만 HLS는 실패합니다

1. FFmpeg 또는 FFplay로 스트림을 검사하고 코덱, 타임스탬프 또는 패키징 오류가 있는지 확인하십시오.
2. 오디오 및 비디오 코덱이 대상 HLS 플레이어와 호환되는지 확인하십시오.
3. 관리자가 오리진 Host 헤더 또는 오리진으로의 Host 설정이 올바른지 확인하도록 요청하십시오.
4. HLS URL, 인증 파라미터, 플레이어 지원 여부를 다시 확인하십시오.

HLS는 비디오만 있고 오디오는 없음

소스 오디오 코덱을 확인하고 대상 HLS 플레이어가 이를 지원하는지 확인하십시오. 동일한 스트림을 RTMP 또는 HTTP-FLV로 비교하세요. 해당 프로토콜에서는 오디오가 정상이고 HLS에서는 오디오가 나오지 않는 경우, AAC 오디오로 스트림을 테스트해 보십시오.

수집해야 할 정보

문제가 계속된다면, 아래 정보를 CDNetworks 지원팀에 제공해 주십시오:

• 비밀 및 인증 서명이 검열된 인제스트 및 재생 URL
• Domain, AppName 및 StreamName
• 프로토콜 및 플레이어 또는 인코더 이름과 버전
• 대략적인 사고 발생 시각(시간대 포함)
• 문제가 인제스트, 재생 또는 둘 다에 영향을 주는지 여부
• 한 명의 시청자에게만 영향이 있는지, 여러 시청자에게 영향이 있는지 여부
• 적절할 경우 및 허용 시 영향을 받는 시청자의 공용 IP 주소
• 인코더 또는 플레이어 오류 메시지 및 관련 로그
• 다른 플레이어, 디바이스, 인코더 또는 네트워크에서의 결과
• 가능하다면 FFmpeg 또는 FFplay 출력

편집되지 않은 자격 증명, 스트림 키, 토큰 또는 인증 비밀을 공유하지 마십시오.