비즈니스용 Skype 2015에서 중앙 로깅 서비스에 대한 공급자 구성

  • 아티클

요약: 비즈니스용 Skype 서버 2015에서 중앙 집중식 로깅 서비스에 대한 시나리오 공급자를 구성하는 방법을 알아봅니다.

중앙 집중식 로깅 서비스에서 공급자의 개념과 구성은 가장 중요한 사항 중 하나입니다. 공급자는 비즈니스용 Skype 서버 추적 모델의 비즈니스용 Skype 서버 서버 역할 구성 요소에 직접 매핑됩니다. 공급자는 추적되는 비즈니스용 Skype 서버 2015의 구성 요소, 수집할 메시지 유형(예: 치명적, 오류 또는 경고) 및 플래그(예: TF_Connection 또는 TF_Diag)를 정의합니다. 공급자는 각 비즈니스용 Skype 서버 서버 역할에서 추적 가능한 구성 요소입니다. 공급자를 사용하여 구성 요소(예: S4, SIPStack, IM 및 프레즌스)에 대한 추적 수준 및 유형을 정의합니다. 정의된 공급자는 특정 문제 조건을 해결하는 지정된 논리 컬렉션에 대한 모든 공급자를 그룹화하기 위해 시나리오에서 사용됩니다.

비즈니스용 Skype 서버 관리 셸을 사용하여 중앙 집중식 로깅 서비스 함수를 실행하려면 CsAdministrator 또는 CsServerAdministrator RBAC(역할 기반 액세스 제어) 보안 그룹 또는 이러한 두 그룹 중 하나를 포함하는 사용자 지정 RBAC 역할의 멤버여야 합니다. 이 cmdlet이 할당된 모든 RBAC(역할 기반 액세스 제어) 역할 목록을 반환하려면(직접 만드는 사용자 지정 RBAC 역할 포함) 비즈니스용 Skype 서버 관리 셸 또는 Windows PowerShell 프롬프트에서 다음 명령을 실행합니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Skype for Business Server 2015 cmdlet"}

예를 들면 다음과 같습니다.

Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsClsConfiguration"}

이 문서의 나머지 부분에서는 공급자를 정의하고 공급자를 수정하는 방법 및 문제 해결을 최적화하기 위해 공급자 정의에 포함된 항목에 중점을 둡니다. 중앙 집중식 로깅 서비스 명령을 실행하는 방법에는 두 가지가 있습니다. 기본적으로 C:\Program Files\Common Files\비즈니스용 Skype 서버 2015\CLSAgent 디렉터리에 있는 CLSController.exe 사용할 수 있습니다. 또는 비즈니스용 Skype 서버 관리 셸을 사용하여 Windows PowerShell 명령을 실행할 수 있습니다. Windows PowerShell 사용하여 로깅 세션에서 사용할 새 공급자를 정의하고 생성, 수집 대상 및 데이터 수집 수준을 완벽하게 제어할 수 있습니다.

Important

언급했듯이 공급자는 매우 강력합니다. 그러나 시나리오는 공급자가 나타내는 구성 요소에서 추적을 설정하고 실행하는 데 필요한 모든 정보의 구현을 포함하기 때문에 더 강력합니다. 시나리오가 공급자 컬렉션인 경우 많은 정보를 수집하는 수백 개의 명령이 포함된 일괄 처리 파일을 실행하는 것과 명령줄에서 한 번에 하나씩 수백 개의 명령을 실행하는 것과 비교하면 느슨할 수 있습니다.

중앙 집중식 로깅 서비스는 공급자의 세부 정보를 자세히 살펴보도록 요구하는 대신 이미 정의된 많은 시나리오를 제공합니다. 제공된 시나리오는 발생할 수 있는 대부분의 문제를 다룹니다. 드물게 공급자를 만들고 정의하고 시나리오에 할당해야 할 수 있습니다. 새 공급자 및 시나리오를 만들어야 하는 필요성을 조사하기 전에 제공된 각 시나리오에 익숙해지는 것이 좋습니다. 공급자를 만드는 방법에 대한 정보는 시나리오에서 공급자 요소를 사용하여 수집하는 방법을 숙지하기 위해 여기에서 찾을 수 있지만, 추적 정보, 공급자 자체에 대한 세부 정보는 현재 제공되지 않습니다.

비즈니스용 Skype 2015의 중앙 집중식 로깅 서비스에 도입된 시나리오에서 사용할 공급자를 정의하는 핵심 요소는 다음과 같습니다.

  • 공급자 OCSLogger에 익숙한 경우 공급자는 추적 엔진이 로그를 수집해야 하는 항목을 OCSLogger에 알리도록 선택하는 구성 요소입니다. 공급자는 동일한 구성 요소이며 대부분의 경우 OCSLogger의 구성 요소와 동일한 이름을 갖습니다. OCSLogger에 익숙하지 않은 경우 공급자는 중앙 집중식 로깅 서비스에서 로그를 수집할 수 있는 서버 역할별 구성 요소입니다. 중앙 집중식 로깅 서비스의 경우 CLSAgent는 공급자 구성에서 정의하는 구성 요소의 추적을 수행하는 중앙 집중식 로깅 서비스의 아키텍처 부분입니다.

  • 로깅 수준 OCSLogger는 수집된 데이터에 대한 여러 수준의 세부 정보를 선택하는 옵션을 제공했습니다. 이 기능은 중앙 집중식 로깅 서비스 및 시나리오의 필수적인 부분이며 Type 매개 변수에 의해 정의됩니다. 다음 중에서 선택할 수 있습니다.

    • 모든 정의된 공급자에 대한 로그에 치명적, 오류, 경고, 자세한 정보 및 디버그 정보의 추적 메시지를 수집합니다.

    • 치명적인 "치명적"으로 정의된 추적 메시지만 수집합니다.

    • 오류 "오류" 또는 "치명적"으로 정의된 추적 메시지만 수집합니다.

    • 경고 "경고", "오류" 및 "치명적" 형식의 추적 메시지만 수집합니다.

    • 정보 정의된 공급자에 대한 정보 메시지와 치명적, 오류 및 경고 메시지를 나타내는 추적 메시지만 수집합니다.

    • 자세한 정의된 공급자에 대한 치명적, 오류, 경고 및 자세한 정보 형식의 모든 추적 메시지를 수집합니다.

    • 디버그 는 기본적으로 'All'과 동일합니다. 정의된 공급자에 대한 치명적, 오류, 경고, 정보, 자세한 정보 및 디버그 유형의 추적을 수집합니다.

  • 플래그 OCSLogger는 추적 파일에서 검색할 수 있는 정보 유형을 정의한 각 공급자에 대한 플래그를 선택하는 옵션을 제공했습니다. 공급자에 따라 다음 플래그를 선택할 수 있습니다.

    • TF_Connection 연결 관련 로그 항목을 제공합니다. 이러한 로그에는 특정 구성 요소와의 연결에 대한 정보가 포함됩니다. 여기에는 중요한 네트워크 수준 정보(즉, 연결 개념이 없는 구성 요소의 경우)도 포함될 수 있습니다.

    • TF_Security 보안과 관련된 모든 이벤트/로그 항목을 제공합니다. 예를 들어 SipStack의 경우 도메인 유효성 검사 실패 및 클라이언트 인증/권한 부여 실패와 같은 보안 이벤트입니다.

    • TF_Diag 구성 요소를 진단하거나 문제를 해결하는 데 사용할 수 있는 진단 이벤트를 제공합니다. 예를 들어 SipStack의 경우 인증서 오류 또는 DNS 경고/오류입니다.

    • TF_Protocol SIP 및 결합된 커뮤니티 코덱 팩 메시지와 같은 프로토콜 메시지를 제공합니다.

    • TF_Component 공급자의 일부로 지정된 구성 요소에 대한 로깅을 사용하도록 설정합니다.

    • 모든 공급자에 사용 가능한 모든 플래그를 설정합니다.

기존 중앙 집중식 로깅 서비스 시나리오 공급자에 대한 정보를 검토하려면

  1. 비즈니스용 Skype 서버 관리 셸 시작: 시작을 클릭하고 모든 프로그램을 클릭한 다음 비즈니스용 Skype 2015를 클릭한 다음 관리 셸 비즈니스용 Skype 서버 클릭합니다.

  2. 기존 공급자의 구성을 검토하려면 다음을 입력합니다.

    Get-CsClsScenario -Identity <scope and scenario name>

    예를 들어 전역 회의 참석자에 대한 정보를 검토하려면 다음을 입력합니다.

    Get-CsClsScenario -Identity "global/CAA"

    명령은 연결된 플래그, 설정 및 구성 요소가 있는 공급자 목록을 표시합니다. 표시되는 정보가 충분하지 않거나 목록이 기본 Windows PowerShell 목록 형식에 비해 너무 길면 다른 출력 방법을 정의하여 추가 정보를 표시할 수 있습니다. 이렇게 하려면 다음을 입력합니다.

    Get-CsClsScenario -Identity "global/CAA" | Select-Object -ExpandProperty Provider

    이 명령의 출력은 공급자 이름, 로깅 유형, 로깅 수준, 플래그, GUID 및 역할이 각각 별도의 줄에 있는 5줄 형식으로 표시된 각 공급자를 표시합니다.

새 중앙 집중식 로깅 서비스 시나리오 공급자를 정의하려면

  1. 비즈니스용 Skype 서버 관리 셸 시작: 시작을 클릭하고 모든 프로그램을 클릭한 다음 비즈니스용 Skype 2015를 클릭한 다음 관리 셸 비즈니스용 Skype 서버 클릭합니다.

  2. 시나리오 공급자는 추적할 구성 요소, 사용할 플래그 및 수집할 세부 정보 수준으로 구성됩니다. 다음을 입력하여 이 작업을 수행합니다.

    $<variableName> = New-CsClsProvider -Name <provider component> -Type <log type> -Level <log level detail type> -Flags <provider trace log flags>

    예를 들어 수집할 내용과 Lyss 공급자의 세부 수준을 정의하는 추적 공급자 정의는 다음과 같습니다.

    $LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Info" -Flags "All"

-Level은 치명적, 오류, 경고 및 정보 메시지를 수집합니다. 사용되는 플래그는 모두 Lyss 공급자에 대해 정의된 플래그이며 TF_Connection, TF_Diag 및 TF_Protocol 포함합니다. 변수 $LyssProvider 정의한 후 New-CsClsScenario cmdlet과 함께 사용하여 Lyss 공급자로부터 추적을 수집할 수 있습니다. 공급자를 만들고 새 시나리오에 할당하려면 다음을 입력합니다.

New-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider $LyssProvider

여기서 $LyssProvider New-CsClsProvider로 만든 정의된 시나리오를 포함하는 변수입니다.

기존 중앙 집중식 로깅 서비스 시나리오 공급자를 변경하려면

  1. 비즈니스용 Skype 서버 관리 셸 시작: 시작을 클릭하고 모든 프로그램을 클릭한 다음 비즈니스용 Skype 2015를 클릭한 다음 관리 셸 비즈니스용 Skype 서버 클릭합니다.

  2. 기존 공급자의 구성을 업데이트하거나 변경하려면 다음을 입력합니다.

    $LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Debug" -Flags "TF_Connection, TF_Diag"

    그런 다음, 다음을 입력하여 공급자를 할당하도록 시나리오를 업데이트합니다.

    Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider $LyssProvider

명령의 최종 결과는 시나리오 사이트:Redmond/RedmondLyssInfo가 할당된 공급자에 대한 플래그와 수준을 업데이트한다는 것입니다. Get-CsClsScenario를 사용하여 새 시나리오를 볼 수 있습니다. 자세한 내용은 Get-CsClsScenario를 참조하세요.

주의

New-ClsCsProvider는 플래그가 유효한지 여부를 확인하기 위해 검사 않습니다. 플래그의 맞춤법(예: TF_DIAG 또는 TF_CONNECTION)의 철자가 올바른지 확인합니다. 플래그의 철자가 올바르지 않으면 공급자가 예상 로그 정보를 반환할 수 없습니다.

이 시나리오에 공급자를 추가하려면 다음을 입력합니다.

Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider @{Add=$ABSProvider, $CASProvider, S4Provider}

Add 지시문으로 정의된 각 공급자가 New-CsClsProvider 프로세스를 사용하여 이미 정의된 위치입니다.

시나리오 공급자를 제거하려면

  1. 비즈니스용 Skype 서버 관리 셸 시작: 시작을 클릭하고 모든 프로그램을 클릭한 다음 비즈니스용 Skype 2015를 클릭한 다음 관리 셸 비즈니스용 Skype 서버 클릭합니다.

  2. 제공된 cmdlet을 사용하면 기존 공급자를 업데이트하고 새 공급자를 만들 수 있습니다. 공급자를 제거하려면 Provider 매개 변수의 Replace 지시문을 Set-CsClsScenario로 사용해야 합니다. 공급자를 완전히 제거하는 유일한 방법은 공급자를 동일한 이름의 재정의된 공급자로 바꾸고 Update 지시문을 사용하는 것입니다. 예를 들어 공급자 LyssProvider는 WPP로 로그 유형으로 정의되고, 수준은 디버그로 설정되고, 플래그 집합은 TF_CONNECTION TF_DIAG. 플래그를 "All"로 변경해야 합니다. 공급자를 변경하려면 다음을 입력합니다.

    $LyssProvider = New-CsClsProvider -Name "Lyss" -Type "WPP" -Level "Debug" -Flags "All"

    Set-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo" -Provider @{Replace=$LyssProvider}

  3. 시나리오와 연결된 공급자를 완전히 제거하려면 다음을 입력합니다.

    Remove-CsClsScenario -Identity <scope and name of scenario>

    예를 들면 다음과 같습니다.

    Remove-CsClsScenario -Identity "site:Redmond/RedmondLyssInfo"

    주의

    Remove-CsClsScenario cmdlet은 확인 메시지를 표시하지 않습니다. 시나리오는 할당된 공급자와 함께 삭제됩니다. 시나리오를 처음 만드는 데 사용되는 명령을 다시 실행하여 시나리오를 다시 만들 수 있습니다. 제거된 시나리오 또는 공급자를 복구하는 절차는 없습니다.

Remove-CsClsScenario cmdlet을 사용하여 시나리오를 제거하는 경우 scope 시나리오를 완전히 제거합니다. 만든 시나리오와 시나리오의 일부인 공급자를 사용하려면 새 공급자를 만들고 새 시나리오에 할당합니다.

참고 항목

Get-CsClsScenario

New-CsClsScenario

Remove-CsClsScenario

Set-CsClsScenario

New-CsClsProvider