프로젝트 관리

Classic/VPC 환경에서 이용 가능합니다.

네이버 클라우드 플랫폼 콘솔을 통해 Effective Log Search & Analytics의 프로젝트를 관리할 수 있는 가이드를 제공합니다.

프로젝트 생성하기

Effective Log Search & Analytics 서비스를 사용하기 위해서는 먼저 프로젝트를 생성해야 합니다.

Effective Log Search & Analytics에서 프로젝트는 로그를 분류해서 저장하고 조회하는 단위입니다. 고객의 용도에 맞게 각기 다른 프로젝트를 생성하고 사용할 수 있습니다. 로그를 전송하고 조회하기 위해서는 최소 1개 이상의 프로젝트가 필요합니다.

네이버 클라우드 플랫폼 콘솔에 접속해 주십시오.
콘솔 화면 우측 상단의 리전 & 플랫폼 버튼을 클릭해 주십시오.
이용 중인 리전과 플랫폼을 선택한 후 [적용] 버튼을 클릭해 주십시오.
콘솔 화면 좌측 상단의 를 클릭해 주십시오.
Services > Management & Governance > Effective Log Search & Analytics 메뉴를 차례대로 클릭해 주십시오.
Projects 메뉴를 선택한 후, [+ 프로젝트 생성하기] 버튼을 클릭합니다.
프로젝트 추가 팝업에서 프로젝트 이름과 설명을 입력 후 [생성] 버튼을 클릭하면 프로젝트 생성이 완료됩니다.
- 프로젝트 이름은 필수 입력값으로 영문 대소문자, 숫자만 입력할 수 있으며 생성된 프로젝트 이름은 변경할 수 없습니다.
- 프로젝트 설명은 최대 85글자 까지 입력 가능합니다.
- 수집된 Log를 매일 지정한 Object Storage의 Bucket으로 Export하기 위한 Log Export 설정을 On/Off 할 수 있습니다.
- Log Export 기능을 사용할 경우, "사용" 선택 후 Log를 보관할 Object Storage의 Bucket을 반드시 선택해야 합니다.
- 프로젝트 생성 이후에도 Log Export 설정을 변경할 수 있습니다.

프로젝트 조회하기

Projects 메뉴에서 생성된 프로젝트의 상세 정보를 확인할 수 있습니다.

1. Projects 메뉴를 선택한 후, 프로젝트 목록에서 상세 정보를 확인할 프로젝트를 선택합니다.

2. 프로젝트 정보에서 프로젝트 이름, 프로젝트 아이디, 설명 등을 확인할 수 있습니다.

3. [수정] 버튼을 클릭하여 프로젝트 설명을 수정하거나, 심볼리케이션 파일을 업로드 할 수 있습니다.

프로젝트 키 확인하기

프로젝트 정보에서 프로젝트 키를 확인할 수 있습니다. 프로젝트 키는 해당 프로젝트에 로그 및 앱 크래시를 전송하는 데 사용됩니다.

프로젝트 키를 클립보드로 바로 복사할 수 있습니다.

Log Export 설정하기

프로젝트 생성 시 설정한 Log Export 기능 사용 여부 및 로그가 보관되는 Bucket 정보를 확인할 수 있습니다.
[수정] 버튼을 클릭하여 설정을 변경할 수 있습니다.

[Export 이력보기] 버튼을 클릭하여 로그의 Export 이력을 확인할 수 있습니다.
Export 이력은 월 단위로 검색이 가능합니다.

심볼리케이션 파일 업로드

심볼 파일의 최대 크기는 200MB입니다.
업로드한 심볼리케이션 파일의 적용에는 5분 가량이 소요됩니다
심볼 파일을 적용한 이후부터 발생한 크래시 로그를 조회 시 심볼리케이션이 적용된 형태로 로그를 확인할 수 있습니다.

1. Projects 메뉴를 선택한 후, 프로젝트 목록에서 심볼리케이션 파일을 업로드할 프로젝트를 선택합니다.

2. 선택한 프로젝트의 조회화면에서 [파일 추가] 버튼을 클릭합니다.

3. 심볼리케이션 파일을 업로드 후, 심볼리케이션 파일을 적용할 플랫폼 및 버전을 입력합니다.

Android, iOS 플랫폼을 선택할 수 있습니다.
프로젝트 버전은 Effective Log Search & Analytics SDK에서 설정하는 버전(Android SDK: projectVersion, iOS SDK: appVer)과 동일해야 합니다.

4. [Upload Files] 버튼을 클릭합니다. 업로드 이후 심볼리케이션 파일의 적용에는 약 5분 가량 소요됩니다.

iOS
- iOS 심볼리케이션 파일을 업로드할 때에는, ZIP 압축 방법으로 BundleName.app.dSYM 파일을 압축하십시오. 결과적으로 아카이브는 아래와 같이 오직 한 파일이 되어야 합니다.
```
$unzip -l test/symbolFiles/ArchiveTest.app.dSYM.zip
Archive: BundleName.app.dSYM.zip
Length   Date Time Name
-------- ---- ---- ----
0        01-07-14 10:25 BundleName.app.dSYM/
0        01-07-14 10:25 BundleName.app.dSYM/Contents/
654      01-07-14 09:59  BundleName.app.dSYM/Contents/Info.plist
0        01-07-14 10:25 BundleName.app.dSYM/Contents/Resources/
0        01-07-14 10:25   BundleName.app.dSYM/Contents/Resources/DWARF/
246845   01-07-14 09:59 BundleName.app.dSYM/Contents/Resources/DWARF/BundleName
-------- -------
247499 6 files     
```
- iOS의 경우, 바이너리 파일의 UUID가 고유하다면 여러 개의 같은 버전과 같은 플랫폼의 파일을 업로드할 수 있습니다. 이는 하나의 프로젝트에서 중복된 UUID는 사용될 수 없음을 의미합니다. 서로 다른 프로젝트에서 같은 UUID를 가진 .dSYM파일을 업로드하는 것은 허용됩니다. UUID는 업로드된 파일로부터 자동으로 추출됩니다.
Android
- Android 심볼리케이션을 업로드할 때에는, mapping.txt 파일을 업로드해야 합니다.
- 새로운 심볼리케이션 파일을 같은 플랫폼에서 업로드할 때에는 항상 버전을 증가시키십시오.
- 만약 같은 버전과 플랫폼의 심볼리케이션 파일을 업로드해야 한다면, 기존 파일을 삭제 후 새로 업로드하십시오.

프로젝트 삭제하기

생성된 프로젝트를 삭제할 수 있습니다. 프로젝트 삭제 시 저장된 로그 데이터는 72시간 동안 임시보관되며, 72시간 이내에 동일한 프로젝트 이름으로 새로운 프로젝트를 생성할 경우 로그 데이터를 다시 확인하실 수 있습니다.

네이버 클라우드 플랫폼 콘솔에서 > Services > Management & Governance > Effective Log Search & Analytics 메뉴를 차례대로 클릭해 주십시오.
Projects 메뉴를 선택한 후, 프로젝트 목록에서 삭제할 프로젝트의 [삭제] 버튼을 클릭합니다.
프로젝트의 삭제 여부를 최종 확인하는 프로젝트 삭제 팝업이 표시됩니다. 해당 팝업에서 [삭제] 버튼을 클릭할 경우, 프로젝트가 최종 삭제됩니다.