Project management

Available in Classic and VPC

This guide explains how to manage Effective Log Search & Analytics projects through the NAVER Cloud Platform console.

Create a Project

To use the Effective Log Search & Analytics service, you must first create a project.

In Effective Log Search & Analytics, a project is a unit for categorizing, storing, and viewing logs. You can create and use different projects for your own purposes. At least one project is required to send and view logs.

1. Access the NAVER Cloud Platform console.
2. Click Region and Platform in the top right corner of the console interface.
3. After selecting your region and platform, click [Apply].
4. Click Menu in the upper left corner of the console interface.
5. Click Services > Management & Governance > Effective Log Search & Analytics menu in order.
6. Select the Projects menu, then click the [+ Create project] button.
   
7. In the Add project popup, enter a project name and description, then click the [Create] button to finish creating the project.
   
   • The project name is a required field and can only be alphanumeric, case-sensitive, and you cannot change the generated project name.
   • The project description can be up to 85 characters long.
   • You can enable or disable the Log Export setting to export collected logs daily to a specified bucket in Object Storage.
   • When using the Log Export feature, you must select a bucket in Object Storage to store the logs after choosing "Enable."
   • You can change the Log Export settings even after the project is created.

Look up a project

You can view the details of the created projects in the Projects menu.

1. Select the Projects menu, then select the project you want to view details about from the list of projects.

2. In Project information, you can see the project name, project ID, description, and more.

3. You can click the [Edit] button to edit the project description, or upload a symbolization file.

Verify Your Project Key

You can find your project key in Project info. The project key is used to send logs and app crashes to that project.

• You can copy the project key directly to the clipboard.

Set Up Log Export

You can see whether the Log Export feature is enabled, which was set when the project was created, and the bucket information where the logs are kept.
Click the [Edit] button to change the settings.

• You can view the export history of the log by clicking the [View export history] button.
• Export history is searchable by month.

Upload a symbolication file

• The maximum size of a symbol file is 200 MB.
• Uploaded symbolication files take about 5 minutes to apply
• When viewing crash logs that have occurred since the symbol file was applied, you can see the logs with the symbolication applied.

1. Select the Projects menu, then select the project you want to upload the symbolication file to from the list of projects.

2. Click the [Add file] button on the lookup screen of the selected project.

3. After uploading the symbolication file, enter the platform and version to which the file should be applied.

• You can select between Android and iOS platforms.
• The Project Version must match the version set in the Effective Log Search & Analytics SDK (Android SDK: projectVersion, iOS SDK: appVer).

4. Click the [Upload Files] button. After uploading, it takes about 5 minutes to apply the symbolication file.

• iOS

  • When uploading an iOS symbolication file, compress the BundleName.app.dSYM file using ZIP. As a result, the archive should be just one file, as shown below.

    $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     
    

  • For iOS, you can upload multiple versions of the same file on the same platform, as long as the binary file's UUID is unique. This means that duplicate UUIDs cannot be used in a single project. Uploading .dSYM files with the same UUID from different projects is allowed. The UUID is automatically extracted from the uploaded file.

• Android

  • When uploading an Android symbolication, you need to upload a mapping.txt file.
  • Always increment the version when uploading a new symbolication file for the same platform.
  • If you need to upload a symbolication file for the same version and platform, delete the existing file and upload a new one.

Deleting a project

You can delete the created project. When you delete a project, the saved log data is temporarily archived for 72 hours, and if you create a new project with the same project name within 72 hours, you can view the log data again.

1. In the NAVER Cloud Platform console, click Menu > Services > Management & Governance > Effective Log Search & Analytics menu in order.
2. Select the Projects menu, and then click the [Delete] button of the project you want to delete from the list of projects.
3. A Delete project popup appears to confirm that you want to delete the project. If you click the [Delete] button in that popup, the project is finally deleted.