이 문서에서는 Trace 탐색기 페이지에서 보고 있는 데이터를 다른 사용자 또는 그룹과 공유하는 방법을 설명합니다. 예를 들어 trace 데이터에서 데이터 이상 또는 추세를 발견하고 다른 사용자가 해당 데이터를 자세히 검사하도록 할 수 있습니다. 또는 누군가 조사해야 하는 개별 트레이스나 스팬에 오류나 예상치 못한 지연 시간 값이 있을 수도 있습니다.
이 기능은 Google Cloud 프로젝트에서만 지원됩니다.
App Hub 구성의 경우 App Hub 호스트 프로젝트 또는 앱 지원 폴더의 관리 프로젝트를 선택합니다.
권장사항
문제 해결을 용이하게 하려면 프로젝트에서 trace 데이터를 확인해야 하는 모든 사용자, 그룹, 도메인에 해당 프로젝트에 대한 Cloud Trace 사용자 역할 (roles/cloudtrace.user)을 부여하는 것이 좋습니다. 이 역할은 주 구성원에게 추적 데이터를 보는 데 필요한 권한을 부여합니다.
시작하기 전에
Google Cloud 콘솔을 사용하여 trace 데이터를 보는 데 필요한 권한을 얻으려면 관리자에게 trace 데이터를 저장하는 프로젝트에 대한 Cloud Trace 사용자 (roles/cloudtrace.user) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
Trace 탐색기 페이지를 사용하여 trace 데이터를 탐색하면 선택한 항목에 따라 브라우저의 URL이 업데이트됩니다. 예를 들어 필터를 추가하거나 기간을 설정하면 페이지의 URL이 수정됩니다.
마찬가지로 스팬 또는 트레이스를 선택하면 스팬 ID와 트레이스 ID가 포함되도록 URL이 업데이트됩니다.
따라서 보고 있는 데이터를 다른 사용자와 공유하려면 페이지 URL을 복사하여 공유하세요. 수신자가 브라우저에 URL을 붙여넣으면 URL에 포함된 설정이 Trace Explorer 페이지의 기본 설정을 재정의합니다. 표시되는 데이터는 URL에서 참조하는 프로젝트에 대한 수신자의 IAM 역할에 따라 달라집니다.
[[["이해하기 쉬움","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-04(UTC)"],[],[],null,["# Share traces and spans\n\nThis document describes how you can share with another person or group the\ndata you are viewing on the **Trace Explorer** page. For example,\nyou might notice a data anomaly or a trend in your trace data and want another\nperson to examine that data in more detail. Or, there might be errors or\nunexpected latency values in an individual trace or span that you\nwant someone to investigate.\n\nThis feature is supported only for Google Cloud projects.\nFor [App Hub](/app-hub/docs/overview)\nconfigurations, select the App Hub host project or\nthe app-enabled folder's management project.\n\nBest practice\n-------------\n\nTo facilitate troubleshooting, we recommend that all people, groups and domains\nthat might need to view trace data in a project be granted the\n[Cloud Trace User role (`roles/cloudtrace.user`)](/iam/docs/understanding-roles#cloudtrace.user) on that\nproject. This role gives principals the permissions they need to view\ntrace data.\n\nBefore you begin\n----------------\n\n\nTo get the permissions that\nyou need to view trace data by using the Google Cloud console,\n\nask your administrator to grant you the\n\n\n[Cloud Trace User](/iam/docs/roles-permissions/cloudtrace#cloudtrace.user) (`roles/cloudtrace.user`)\nIAM role on the projects that store your trace data.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\nShare trace data\n----------------\n\nWhen you use the **Trace Explorer** page to explore your trace data,\nthe selections that you make update the URL in your browser. For example, if\nyou add filters or set the time range, then the URL to the page is modified.\nSimilarly, if you select a span or a trace, the URL is updated to include\nthe span ID and trace ID.\n\nTherefore, to share the data you are viewing with another person, copy the\npage URL and share it. When the recipient pastes the URL into\ntheir browser, the settings contained in the URL override any default settings\nfor the **Trace Explorer** page. The displayed data depends on the\nrecipient's IAM roles on the projects referenced by the URL.\n\nTo share trace data, do the following:\n\n1. In the Google Cloud console, go to the **Trace explorer** page:\n\n [Go to **Trace explorer**](https://console.cloud.google.com/traces/explorer)\n\n \u003cbr /\u003e\n\n You can also find this page by using the search bar.\n2. In the toolbar of the Google Cloud console, select your Google Cloud project. For [App Hub](/app-hub/docs/overview) configurations, select the App Hub host project or the app-enabled folder's management project.\n3. Configure the **Trace Explorer** page to show the data that you\n want to share.\n\n For example, you might want to add filters, update the time-range selector,\n or change the **Scope** element, which controls which projects are searched\n for trace data.\n\n If the first menu of the **Scope** element is set to\n **Project** or to **_Default** , then\n your project is searched for trace data. Otherwise, the projects listed in\n the trace scope are searched. For more information, see\n [Create and manage trace scopes](/trace/docs/trace-scope/create-and-manage).\n\n If you want to share the URL for a trace or span,\n then open the **Details** flyout for\n that trace or span by doing one of the following:\n - In the toolbar, click *pageview* **Search for trace**\n and then enter the trace ID.\n\n - Find and select a span.\n\n4. Copy the URL in your browser, and then share that URL.\n\nTroubleshoot\n------------\n\nFor information about how to resolve problems like a trace missing spans\nor not seeing any data in the **Trace Explorer** page, see\n[Troubleshoot](/trace/docs/troubleshooting).\n\nWhat's next\n-----------\n\n- [Find and explore traces](/trace/docs/finding-traces)\n- [Create and manage trace scopes](/trace/docs/trace-scope/create-and-manage)\n- [View traces across projects](/trace/docs/cross-project-traces)\n- [Troubleshoot](/trace/docs/troubleshooting)"]]