Looker에는 기본 제공 시각화 유형의 강화된 목록이 포함되어 다양한 방식으로 데이터를 차트로 작성할 수 있습니다. Looker의 기본 시각화 유형에 포함되지 않은 차트 유형이 필요한 경우 Looker 인스턴스에 커스텀 JavaScript 시각화를 추가하는 여러 방법을 제공합니다.
LookML 프로젝트의 매니페스트 파일에 visualization 매개변수를 추가하여 LookML 프로젝트에 직접 커스텀 시각화를 추가합니다. 자세한 내용은 visualization 파라미터 문서 페이지를 참고하세요.
Looker Marketplace에서 시각화를 설치합니다. Marketplace 기능을 사용 설정하면 Looker Marketplace 시각화 패키지를 설치할 수 있습니다.
Looker의 관리자 메뉴에 있는 플랫폼 섹션의 시각화 페이지를 사용하여 Looker의 커스텀 시각화 저장소에서 커스텀 JavaScript 시각화를 설치하고 관리합니다.
이 페이지에서는 Looker 관리자 패널에서 시각화 페이지를 사용하여 커스텀 JavaScript 시각화를 추가하는 방법을 설명합니다.
맞춤 시각화 목록 보기
다운로드한 시각화의 모든 기능을 확인하려면 고객이 호스팅하는 배포의 관리자는 적절한 버전의 Chromium 렌더러를 설치해야 합니다.
Looker의 관리 메뉴에 있는 플랫폼 섹션의 시각화 페이지에는 Looker 인스턴스에 추가된 모든 맞춤 시각화가 나열됩니다.
작업: 시각화 구성을 수정하거나 삭제하는 버튼입니다. LookML 프로젝트의 매니페스트 파일을 사용하여 추가한 시각화에는 이러한 버튼이 표시되지 않습니다. 이러한 시각화는 LookML 프로젝트의 매니페스트 파일로 이동하여 visualization 매개변수를 직접 수정해야 합니다.
맞춤 시각화 가져오기
다음과 같은 다양한 소스에서 시각화를 가져와 Looker 인스턴스에 추가하고 맞춤설정할 수 있습니다.
Looker는 이 Looker GitHub 페이지에서 공개적으로 사용할 수 있는 맞춤 시각화 라이브러리를 유지관리합니다. Looker GitHub 페이지에서 Looker의 시각화 API를 사용하여 자체 시각화 유형을 만드는 방법을 확인할 수 있습니다.
시각화('플러그인')를 찾아보고 소스 코드에 액세스할 수 있는 독립형 Looker Marketplace
Looker 인스턴스에서 액세스할 수 있는 Looker Marketplace입니다. 이 Marketplace에서 시각화를 직접 탐색하고 Looker 인스턴스에 설치할 수 있습니다. Looker Marketplace에서 시각화를 설치하는 방법에 대한 자세한 내용은 Looker Marketplace 사용 문서 페이지를 참고하세요.
새 맞춤 시각화 추가
인스턴스에 추가할 시각화를 결정 후 Looker의 관리자 메뉴에서 플랫폼 섹션의 시각화 페이지를 사용하여 시각화 추가 버튼을 선택하여 커스텀 시각화를 추가할 수 있습니다.
Looker에 새 시각화 페이지가 표시됩니다. 새 시각화를 추가하려면 다음 단계를 따르세요.
ID 필드에 시각화 JavaScript에 정의된 시각화의 고유 ID를 입력합니다.
라벨 필드에 시각화의 이름을 입력합니다. Looker는 Explore의 Looker 시각화 메뉴에 이 이름을 표시합니다.
Looker가 자바스크립트 코드 저장소를 가리키도록 기본 필드에 시각화의 기본 자바스크립트 파일의 URI를 입력합니다.
커스텀 시각화 코드를 호스팅하는 사이트에서 확인을 위해 하위 리소스 무결성 (SRI) 해시를 사용하는 경우 SRI 해시 필드에 SRI 해시를 입력합니다. 이 필드는 고급 옵션 아래에서 확인할 수 있습니다. Looker의 맞춤 시각화 호스트는 SRI 해시를 사용하지 않습니다.
종속 항목 필드에서 시각화 JavaScript가 종속된 다른 파일의 URI를 입력하고 추가를 클릭합니다. 쉼표로 구분하여 여러 URI를 입력하거나 URI를 한 번에 하나씩 추가할 수 있습니다. 종속 항목 필드는 고급 옵션 아래에서 확인할 수 있습니다.
저장을 선택합니다.
시각화가 추가되면 Explore의 시각화 메뉴에서 사용자가 라벨을 지정한 대로 표시됩니다. Looker의 기존 시각화 유형과 마찬가지로 새 시각화 유형을 사용할 수 있습니다.
기존 시각화를 수정하려면 시각화 오른쪽에 있는 수정 버튼을 선택합니다. Looker는 시각화를 추가하는 데 사용하는 것과 동일한 페이지(새 커스텀 시각화 추가에 설명되어 있음)를 표시하지만 관련 정보가 이미 입력되어 있습니다. 원하는 대로 변경한 다음 저장을 클릭합니다.
맞춤 시각화 삭제
시각화를 삭제하려면 Looker의 관리자 메뉴 플랫폼 섹션의 시각화 페이지에서 시각화 오른쪽에 있는 삭제 버튼을 선택한 다음, 확인 상자에서 확인을 클릭하세요.
시각화를 삭제하면 Looker에서 삭제되지만 시각화의 외부 코드 저장소에는 영향을 미치지 않습니다.
시각화를 삭제하면 해당 시각화 유형을 사용하는 Look 또는 대시보드가 사용 중지됩니다. 삭제된 시각화를 동일한 시각화 ID로 다시 추가하여 이를 수정할 수 있습니다.
문제 해결
커스텀 시각화는 커뮤니티에서 지원하는 기능입니다. Looker 지원팀은 커스텀 시각화 또는 커스텀 시각화 코드와 관련된 문제를 해결하지 않습니다. 버그를 추적하고 제거하려면 커스텀 시각화 저장소의 GitHub 문제를 사용하거나 커스텀 시각화와 관련된 방법 게시물, 대화, 팁을 확인하려면 Looker 커뮤니티를 방문하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-05(UTC)"],[],[],null,["# Admin settings - Visualizations\n\nLooker includes a robust list of built-in [visualization types](/looker/docs/visualization-types), letting you chart your data in a variety of ways. If you need a type of chart that is not included in Looker's built-in visualization types, Looker provides several ways to add custom JavaScript visualizations to your Looker instance:\n\n1. Add a `visualization` parameter to your LookML project's manifest file to add custom visualizations directly to your LookML project. See the [`visualization`](/looker/docs/reference/param-manifest-visualization) parameter documentation page for more information.\n2. Install a visualization from the Looker Marketplace. With the [**Marketplace**](/looker/docs/admin-panel-platform-marketplace) feature enabled, you can install Looker Marketplace visualization packages.\n3. Use the **Visualizations** page in the **Platform** section of Looker's **Admin** menu to install and administer custom JavaScript visualizations from Looker's custom visualizations repository.\n\nThis page describes how to add custom JavaScript visualizations using the **Visualizations** page in the Looker **Admin** panel.\n| **Note:** If you have a permission that provides access to only select pages in the Admin panel, such as [`manage_schedules`](/looker/docs/admin-panel-users-roles#manage_schedules), [`manage_themes`](/looker/docs/admin-panel-users-roles#manage_themes), or [`see_admin`](/looker/docs/admin-panel-users-roles#see_admin), but you don't have the [Admin role](/looker/docs/admin-panel-users-roles#default_roles), the page or pages that are described here may not be visible to you in the Admin panel.\n\nViewing a list of custom visualizations\n---------------------------------------\n\nTo obtain full functionality of downloaded visualizations, admins for customer-hosted deployments should make sure to install the appropriate version of the [Chromium renderer](/looker/docs/installation-of-rendering-software#chromium).\n\nThe **Visualizations** page in the **Platform** section of Looker's **Admin** menu lists all the custom visualizations that have been added to your Looker instance.\n\nThe list includes the following columns:\n\n- **ID** : The unique ID assigned to the custom visualization. This value is assigned either in the JavaScript code, or when you [add](#adding_a_new_custom_visualization_manifest) or [edit](#editing_a_custom_visualization_manifest) a visualization using the **Admin** page, or in the visualization's [`id`](/looker/docs/reference/param-manifest-visualization#id) parameter when you [add a visualization using the LookML project manifest file](/looker/docs/reference/param-manifest-visualization).\n- **Label** : The name given to the visualization type in the Looker visualization menu. This value is assigned when you [add](#adding_a_new_custom_visualization_manifest) or [edit](#editing_a_custom_visualization_manifest) a visualization using the Admin page, or in the visualization's [`label`](/looker/docs/reference/param-manifest-visualization#label) parameter when you [add a visualization using the LookML project manifest file](/looker/docs/reference/param-manifest-visualization).\n- **Main** : The URI of the visualization's main JavaScript code. This value is assigned when you [add](#adding_a_new_custom_visualization_manifest) or [edit](#editing_a_custom_visualization_manifest) a visualization using the Admin page, or in the visualization's [`url`](/looker/docs/reference/param-manifest-visualization#url) parameter when you [add a visualization using the LookML project manifest file](/looker/docs/reference/param-manifest-visualization).\n- **Actions** : Buttons to edit or delete the visualization configuration. These buttons are not shown for visualizations added using the [LookML project's manifest file](/looker/docs/reference/param-manifest-visualization). To edit these visualizations, go to the LookML project's manifest file and edit the [`visualization`](/looker/docs/reference/param-manifest-visualization) parameter directly.\n\nSourcing a custom visualization\n-------------------------------\n\nYou can obtain visualizations to customize and add to your Looker instance from a variety of sources, including the following:\n\n- Looker maintains a library of custom visualizations for public use on this [Looker GitHub page](https://github.com/looker-open-source/custom_visualizations_v2). You can find instructions for using Looker's Visualization API to create your own visualization types on this [Looker GitHub page](https://github.com/looker-open-source/custom_visualizations_v2/blob/master/docs/getting_started.md).\n- The standalone Looker Marketplace, where you can browse for visualizations --- called \"plug-ins\" --- and access their source code.\n- The Looker Marketplace that is accessible from your Looker instance. From this Marketplace, you can browse and install visualizations directly into your Looker instance. See the [Using the Looker Marketplace](/looker/docs/marketplace) documentation page for more information about installing visualizations from the Looker Marketplace.\n\n\nAdding a new custom visualization\n---------------------------------\n\nOnce you know which visualization you'd like to add to your instance, you can use the The **Visualizations** page in the **Platform** section of Looker's **Admin** menu to add a custom visualization by selecting the **Add Visualization** button.\n\nLooker displays the **New Visualization:** page. To add a new visualization, perform the following steps:\n\n1. In the **ID** field, enter the unique ID of the visualization defined in the visualization JavaScript.\n\n2. In the **Label** field, enter the name of the visualization. Looker displays this name in the Looker visualization menu on an Explore.\n\n3. In the **Main** field, enter the URI of the visualization's main JavaScript file to point Looker to your JavaScript code repository.\n\n4. If the site that hosts your custom visualization code uses a [subresource integrity (SRI) hash](https://en.wikipedia.org/wiki/Subresource_Integrity) for verification purposes, enter the SRI hash in the **SRI Hash** field. This field can be found under **Advanced options**. Looker's custom visualization hosts don't use an SRI hash.\n\n5. In the **Dependencies** field, enter the URIs of any other files that the visualization JavaScript is dependent upon, and click **Add** . You can enter multiple URIs separated by commas, or you can add multiple URIs one at a time. The **Dependencies** field can be found under **Advanced options**.\n\n6. Select **Save**.\n\nOnce the visualization has been added, you will see it as you've labeled it in the visualization menu in an Explore. You can use the new visualization type like any of Looker's existing visualization types.\n\nTo view custom visualizations from the visualization menu:\n\n1. Select the **`...`** three-dot icon from the [visualization menu bar](/looker/docs/creating-visualizations#quick_guide) to access the custom visualization.\n\n2. Once the visualization is selected, the name of the visualization appears on the visualization menu bar.\n\n\nEditing a custom visualization\n------------------------------\n\nTo edit an existing visualization, select the **Edit** button to the right of the visualization. Looker displays the same page that you use to add a visualization (described in [Adding a new custom visualization](#adding_a_new_custom_visualization)), but with the relevant information already filled in. Make any preferred changes, and then click **Save**.\n\n\nDeleting a custom visualization\n-------------------------------\n\nTo delete a visualization, select the **Delete** button to the right of the visualization on the **Visualizations** page in the **Platform** section of Looker's **Admin** menu, and then click **OK** in the confirmation box.\n\nDeleting a visualization removes it from Looker but won't affect anything in the visualization's external code repository.\n\nDeleting a visualization disables any Looks or dashboards that use that visualization type. You can correct that by adding back the deleted visualization with the same visualization ID.\n\nTroubleshooting\n---------------\n\nCustom visualizations are a community-supported effort. Looker's support team does not troubleshoot issues relating to custom visualizations or your custom visualization code. For tracking and closing out bugs, use GitHub issues in the custom visualization's repository, or visit the [Looker Community](https://www.googlecloudcommunity.com/gc/Looker/ct-p/looker) for how-to posts, conversations, and tips regarding custom visualizations."]]