서비스 아키텍처 인텔리전스를 위한 GitHub 통합

GitHub 계정의 데이터를 활용하여 서비스에 대한 인사이트를 더욱 심도 있게 얻고 싶으신가요? 뉴렐릭 GitHub 통합은 선택적 데이터 가져오기 기능을 통해 사용자, 팀 및 사용자 데이터를 뉴렐릭 플랫폼으로 직접 가져옵니다.

이러한 통합을 통해 사용자와 팀의 온보딩 프로세스가 간소화되고 역할 관리도 간소화됩니다. 또한 소유권 상호 관계를 명확히 하여 설정 시간과 노력을 줄여줍니다. 새로운 선택적 데이터 가져오기 기능을 사용하면 팀과 사용자, 저장소와 풀 요청 또는 둘 다 등 가져올 데이터 유형을 정확하게 선택할 수 있습니다. 이 통합 AI 모니터링은 뉴렐릭 내의 카탈로그 및 스코어카드 의 관리 및 가시성을 향상합니다. 자세한 내용은 서비스 아키텍처 인텔리전스 기능을 참조하세요.

• 지원되는 플랫폼:

  • GitHub 클라우드
  • GitHub Enterprise(GHE) 클라우드(데이터 상주 없음)

• 지원 지역: 미국 및 EU 지역

필수 조건:

• 통합하려는 GitHub 계정에 로그인하세요.

• 조직 관리자 또는 인증 도메인 관리자여야 합니다.

• 필요한 권한:

  • teams_discount_usage
  • integration_github_discount_usage
  • integration_github_ccu

IP 화이트리스트/포함 요구사항

귀하의 조직이 아웃바운드 연결에 IP 화이트리스트/포함을 사용하는 경우 데이터 수집기 엔드포인트의 트래픽을 허용해야 합니다.

허용 IP 주소의 전체 및 최신 목록을 화이트리스트/포함 설정에 추가하려면 공식 뉴렐릭 공개 문서를 참조하세요.

어떤 데이터를 동기화할 수 있나요?

GitHub 통합을 사용하면 뉴렐릭으로 가져올 데이터 유형을 선택적으로 선택할 수 있으므로 어떤 정보가 동기화되는지 제어할 수 있습니다.

사용 가능한 데이터 유형

• 팀 및 사용자: GitHub 팀 구조 및 사용자 정보를 가져와 팀 관리 및 소유권 매핑을 강화합니다.

  중요

  사용자 이메일 가시성 요구 사항: 통합은 GitHub 프로필 설정에서 이메일 주소를 공개로 구성한 GitHub 사용자만 가져옵니다. 개인 이메일 설정을 사용하는 팀원은 사용자 데이터 동기화 프로세스에서 제외됩니다.

• 사용자 및 끌어오기: 더 나은 코드 가시성 및 구현, 배포 추적을 위해 데이터를 가져오고 정보를 가져옵니다.

• 둘 다: 포괄적인 GitHub 통합을 위해 사용 가능한 모든 데이터 유형을 가져옵니다.

데이터 선택 고려 사항

초기 설정 과정에서 데이터 선택 기본 설정을 구성할 수 있습니다.

GitHub 통합 설정

1. one.newrelic.com > + Integration & Agents > GitHub integration 으로 이동합니다.

2. Select an action [작업 선택] 단계에서 Set up a new integration [새 통합 설정을] 선택하고 Continue [계속을] 클릭합니다.

3. Begin integration [통합 시작] 화면에서:

   a. GitHub 계정에 연결하려면 Get started in GitHub [GitHub에서 시작하기를] 클릭합니다. 뉴렐릭 옵션저버빌리티가 GitHub 마켓플레이스에서 열립니다. 비. 선택한 데이터 유형과 관련된 데이터를 검색하려면 GitHub 조직 내에서 앱 설치를 완료하세요. 설치가 완료되면 Select an action [작업 선택] 단계로 한 번 더 이동하게 됩니다. 기음. Begin integration [통합 시작을] 선택하고 Continue [계속을] 클릭합니다.

   d. Select your data preferences [데이터 기본 설정 선택]: 동기화할 데이터 유형을 선택하세요.

   • Teams + Users [Teams + 사용자]: GitHub 팀 구조 및 사용자 정보 가져오기
   • Repositories + Pull Requests [표면 + 당겨]: 표면을 가져오고 데이터를 가져옵니다.
   • Both [둘 다]: 사용 가능한 모든 데이터 유형을 가져옵니다.

   팁

   팀이 다른 소스(예: 서비스 팀)에서 이미 통합된 경우 충돌을 방지하기 위해 Teams + Users [팀 + 사용자] 옵션이 비활성화됩니다.

   e. Start first sync [첫 번째 동기화 시작]을 클릭하여 선택한 데이터 유형을 가져오기 시작합니다.

   g. Sync started [동기화 시작] 메시지가 표시된 후 Continue [계속을] 클릭합니다. Integration status [통합 상태] 화면에는 선택한 데이터 유형(팀, 저장소 등)의 수가 표시되며 5초마다 새로 고쳐집니다. 모든 데이터를 완전히 가져오는 데 몇 분이 걸릴 수 있습니다.

   

4. (선택 사항) GitHub integration [GitHub 통합] 화면에서 가져온 데이터에 액세스합니다.

   • 설정 중에 팀을 Go to Teams [선택한 경우] Teams 에서 가져온 팀 정보를 보려면 '팀으로 이동 '을 클릭하세요.
   • Go to Repositories [클립으로 이동을] 클릭하면 클립 에서 가져온 클립 정보를 볼 수 있습니다(설정 중에 클립을 선택한 경우).

   팁

   팀에 저장소 자동 할당: GitHub에서 teamOwningRepo 사용자 정의 속성을 만들어 GitHub 저장소를 해당 팀에 자동으로 할당할 수 있습니다. 조직 수준에서 사용자 정의 속성을 만들고 저장소 수준에서 사용자 정의 속성에 대한 값을 할당합니다. 또한 조직 수준에서 여러 저장소에 대한 사용자 정의 속성을 동시에 설정할 수 있습니다. 통합을 통해 사용자 정의 속성에 따라 각 팀에 저장소가 자동으로 할당됩니다. 사용자 정의 속성을 만드는 방법에 대한 자세한 내용은 GitHub 설명서를 참조하세요.

팀 소유권 검색 활성화

GitHub 통합에는 GitHub의 조직 구조와 사용자 정의 속성을 기반으로 저장소의 팀 소유권을 자동으로 설정할 수 있는 검색 서비스가 포함되어 있습니다.

팀 소유권이 작동하는 방식

검색 서비스는 여러 가지 방법을 사용하여 저장소 소유권을 설정합니다.

1. GitHub 사용자 정의 속성: teamOwningRepo 사용자 정의 속성을 사용하여 팀에 저장소를 직접 할당합니다.
2. 팀 멤버십 분석: 커밋 패턴과 팀원 기여도를 분석하여 소유권을 추론합니다.
3. 저장소 구성: GitHub의 조직 구조와 팀 권한을 사용하여 소유권을 결정합니다.

자동 팀 소유권 설정

자동 팀 소유권 검색을 활성화하려면:

1. GitHub에서 사용자 정의 속성을 만듭니다 (권장):

   • GitHub 조직 설정으로 이동합니다.
   • 조직 수준에서 teamOwningRepo 사용자 정의 속성을 만듭니다.
   • 구성원 수준에서 구성원에게 팀 가치를 할당합니다.
   • 통합은 동기화 중에 이러한 관계를 자동으로 매핑합니다.

2. 팀 권한 구성:

   • 팀이 GitHub에서 적절한 저장소 액세스 권한을 가지고 있는지 확인하세요.
   • 검색 서비스는 이러한 권한을 사용하여 소유권 관계를 추론합니다.

3. 자동 팀 소유권 검색 활성화:

   • 동기화가 완료되면 뉴렐릭에서 자동 팀 소유권 검색을 활성화합니다. 자세한 내용은 팀 자동화 소유권 문서를 참조하세요.
   • 소유권 관계가 올바르게 설정되었는지 확인하세요.

GitHub 통합 관리

GitHub 통합을 설정한 후에는 뉴렐릭 인터페이스를 통해 관리할 수 있습니다. 여기에는 데이터 새로 고침, 설정 편집, 필요 시 설치 제거가 포함됩니다.

액세스 통합 관리

1. one.newrelic.com > + Integration & Agents > GitHub integration 으로 이동합니다.

2. Select an action [작업 선택] 단계에서 Manage your organization [조직 관리를] 선택하고 Continue [계속을] 클릭합니다.

   

Manage GitHub integration [GitHub 통합 관리] 화면에는 연결된 조직과 해당 조직의 현재 동기화 상태 및 데이터 유형이 표시됩니다.

데이터 새로 고침

Refresh data [데이터 새로 고침] 옵션을 클릭하면 뉴렐릭에서 GitHub 데이터를 업데이트하는 간소화된 방법이 제공됩니다.

데이터를 새로 고치려면:

1. Manage GitHub integration [GitHub 통합 관리] 화면에서 조직을 찾으세요.

2. 업데이트하려는 조직 옆에 있는 Refresh data [데이터 새로 고침을] 클릭한 다음 Continue [계속을] 클릭합니다.

3. Refresh Data [데이터 새로 고침] 단계에서 Sync on demand [주문형 동기화를] 클릭합니다.

그러면 시스템에서 GitHub 권한과 조직 액세스를 검증하고, 마지막 동기화 이후 새 데이터나 변경된 데이터만 가져오고, 선택한 데이터 유형에 따라 업데이트된 데이터를 처리하고 매핑하고, 최신 동기화 타임스탬프와 데이터 수를 반영하도록 통합 상태를 업데이트합니다.

새로고침되는 내용:

• GitHub 팀에 새로운 팀원이 추가되었습니다.
• 포인터 변경(새 리포지터리, 보관된 리포지터리, 권한 변경)
• 사용자 정의 속성을 통해 업데이트된 팀 소유권
• 사용자 프로필 및 팀 구조 변경

통합 설정 편집

초기 설정 후 통합 구성을 수정하려면 Edit [편집] 옵션을 사용하세요. 현재 요구 사항에 따라 Teams + 사용자, 저장소 + 풀 요청 또는 두 데이터 유형 모두 중에서 선택하여 GitHub와 뉴렐릭 간에 동기화되는 데이터 유형을 조정할 수 있습니다.

GitHub 통합을 편집하려면:

1. Manage GitHub integration [GitHub 통합 관리] 화면에서 조직을 찾으세요.

2. 업데이트하려는 조직 옆에 있는 Edit [편집]을 클릭한 다음 Continue [계속]을 클릭합니다.

3. Edit Integration Settings [통합 설정 편집] 단계에서 필요에 따라 데이터 유형 선택 사항을 조정합니다.

4. Save changes [변경 사항 저장을] 클릭하여 업데이트를 적용하세요.

편집 중에 무슨 일이 일어나는가:

• 설정 변경 중에도 현재 데이터는 그대로 유지됩니다.
• 새로운 설정은 후속 동기화에 적용됩니다.
• 변경 사항을 적용하기 전에 미리 볼 수 있습니다.
• 변경 사항을 저장할 때까지 이전 설정으로 통합이 계속 실행됩니다.

GitHub 통합 제거

GitHub 통합을 제거하면 선택한 기관의 데이터 동기화가 중지되지만 이전에 뉴렐릭에 가져온 모든 데이터는 보존됩니다.

제거하려면:

1. Manage GitHub integration [GitHub 통합 관리] 화면에서 제거하려는 조직을 찾아 Uninstall [제거를] 클릭합니다.

2. 확인 대화 상자에서 조직 세부 정보를 검토하고 Uninstall organization [조직 제거를] 클릭하여 확인합니다.

3. 제거가 완료되었음을 확인하는 성공 메시지가 표시됩니다.