NerdGraph 튜토리얼: 공개 공유 대시보드 URL 생성, 업데이트 및 취소

필요한 보안 및 액세스가 설정 되면 NerdGraph 에서 Query와 뮤테이션을 사용하여 공개적으로 액세스 가능한 라이브 대시보드 URL을 만들고, 관리하고, 취소할 수 있습니다. 뉴렐릭 UI 에서도 이 작업을 수행할 수 있습니다.

주의

공유 대시보드가 암호로 보호되지 않은 경우 라이브 URL을 가진 사람은 누구나 대시보드에 포함된 모든 정보에 액세스하여 볼 수 있습니다. 원치 않는 접근을 방지하려면 암호로 보호된 URL을 만들 거나 기존 공유 URL에 대한 암호 보호를 활성화하세요.

NerdGraph에서 공개적으로 접근 가능한 라이브 대시보드 URL을 생성, 업데이트 또는 취소하려면 공유하려는 대시보드의 GUID가 필요합니다.

one.newrelic.com > Dashboards 으)로 이동합니다.
공유하려는 대시보드를 엽니다.
> Metadata 으로 이동하여 대시보드의 GUID를 복사합니다.

NerdGraph API 탐색기 로 이동합니다.
다음 호출과 함께 dashboardCreateLiveUrl 변형을 사용하여 그래프 API 실행을 구성합니다.

GUID: 대시보드의 GUID를 입력하세요.
Options(선택 사항) > ttl: URL이 활성화되는 기간을 초 단위로 입력합니다.
- 최소값: 300초(5분)
- 최대값: 631152000초(20년)
- 기본값: 2592000초(30일)
url: 응답에서 라이브 대시보드 URL을 얻으려면 이것을 선택하세요.
응답에 포함할 다른 필드를 선택하세요.
샘플 돌연변이
```
mutation {
  dashboardCreateLiveUrl(
    options: {ttl: time in seconds}
    guid: "YOUR_DASHBOARD_GUID"
  ) {
    url
  }
}
```
라이브 대시보드 URL이 응답에 나타납니다. 이것은 공개 URL이므로 누구와도 공유할 수 있습니다.
샘플 응답
```
{
  "data": {
    "dashboardCreateLiveUrl": {
      "url": "https://share.newrelic.com/dashboard/PUBLIC_LINK_ID"
    }
  }
}
```
PUBLIC_LINK_ID 은 공유 대시보드의 ID입니다. NerdGraph를 통해 공유 대시보드 URL을 업데이트하거나 취소할 수 있습니다.
중요
뉴렐릭 플랫폼 대시보드의 모든 콘텐츠 업데이트는 공유 대시보드 페이지에 반영됩니다.

공유 대시보드에 대한 원치 않는 액세스를 방지하려면 암호 보호 기능이 있는 라이브 대시보드 URL을 만들 수 있습니다.

NerdGraph API 탐색기 로 이동합니다.
다음 호출과 함께 dashboardCreateLiveUrl 변형을 사용하여 그래프 API 실행을 구성합니다.

auth > factors > type: 라이브 대시보드 URL에 대한 암호 보호를 활성화하려면 PASSWORD 선택하세요.
GUID: 대시보드의 GUID를 입력하세요.
Options(선택 사항) > ttl: URL이 활성화되는 기간을 초 단위로 입력합니다.
- 최소값: 300초(5분)
- 최대값: 631152000초(20년)
- 기본값: 2592000초(30일)
auth > factors > password > value: 응답에서 라이브 대시보드 비밀번호를 얻으려면 이것을 선택하세요.
url: 응답에서 라이브 대시보드 URL을 얻으려면 이것을 선택하세요.

응답에 포함할 다른 필드를 선택하세요.

샘플 돌연변이

mutation {
  dashboardCreateLiveUrl(
    guid: "YOUR_DASHBOARD_GUID"
    options: { ttl: 3600 } # Optional: Set a time-to-live for the URL
    auth: { factors: [{ type: PASSWORD }] }
  ) {
    url
    uuid
    auth {
      factors {
        type
        password {
          value # REQUEST THE PASSWORD VALUE HERE
        }
      }
    }
  }
}

라이브 대시보드 URL과 비밀번호가 응답에 표시됩니다.

샘플 응답

{
  "data": {
    "dashboardCreateLiveUrl": {
      "auth": {
        "factors": [
          {
            "password": {
              "value": "pfd-3ZZ46#3a4On5p%&¿"
            },
            "type": "PASSWORD"
          }
        ]
      },
      "url": "https://one.newrelic.com/dashboard/f6c730bf-fced-4890-ad6e-86ab6a6e8159",
      "uuid": "f6c730bf-fced-4890-ad6e-86ab6a6e8159"
    }
  }
}

uuid 은 공유 대시보드의 ID입니다. NerdGraph를 통해 공유 대시보드 URL을 업데이트 하거나 취소할 수 있습니다. 외부 사용자와 대시보드를 공유하려면 응답에서 URL과 비밀번호를 복사하세요. 비밀번호는 나중에 검색할 수 없습니다. 비밀번호를 분실한 경우 비밀번호를 재설정한 후 사용자와 다시 공유하기만 하면 됩니다. 비밀번호를 안전하게 관리하려면 비밀번호 관리 모범 사례를 따르세요.

공유 대시보드의 설정을 수정할 수 있는 권한이 있는지 확인하세요.

URL이 활성화되는 기간을 업데이트하려면:

NerdGraph API 탐색기 로 이동합니다.
다음 호출과 함께 dashboardUpdateLiveUrl 변형을 사용하여 그래프 API 실행을 구성합니다.

id: 공유 대시보드 URL에서 ID를 복사하여 입력합니다.
Options (선택 사항) > ttl: URL이 활성화되는 기간을 초 단위로 입력합니다.
- 최소값: 300초(5분)
- 최대값: 631152000초(20년)
- 기본값: 2592000초(30일)
샘플 돌연변이
```
mutation {
  dashboardUpdateLiveUrl(
    id: "enter the public URL ID"
    options: { ttl: "updated duration in seconds" }
  )
}
```
URL은 응답에 다음과 같이 나타납니다. 이제 URL은 업데이트된 기간 동안 활성화됩니다.
샘플 응답
```
{
  "data": {
    "dashboardUpdateLiveUrl": {
      "url": "https://share.newrelic.com/dashboard/PUBLIC_LINK_ID"
    }
  }
}
```

공유 대시보드의 설정을 수정할 수 있는 권한이 있는지 확인하세요. 라이브 대시보드 URL에 대한 암호 보호를 활성화하려면:

NerdGraph API 탐색기 로 이동합니다.
다음 호출과 함께 dashboardUpdateLiveUrlAuth 변형을 사용하여 그래프 API 실행을 구성합니다.

auth > factors > type: 라이브 대시보드 URL에 대한 암호 보호를 활성화하려면 PASSWORD 선택하세요.
id: 공유 대시보드 URL에서 ID를 복사하여 입력합니다.
auth > factors > password > value: 응답에서 라이브 대시보드 비밀번호를 얻으려면 이것을 선택하세요.
응답에 포함할 다른 필드를 선택하세요.
샘플 돌연변이
```
mutation {
  dashboardUpdateLiveUrlAuth(
    id: "YOUR_PUBLIC_LINK_UUID"
    auth: { factors: [{ type: PASSWORD }] }
  ) {
    factors {
      password {
        value # A NEW PASSWORD WILL BE GENERATED AND RETURNED
      }
      type
    }
  }
}
```
샘플 응답
응답에서 비밀번호는 다음과 같이 나타납니다.
```
{
  "data": {
    "dashboardUpdateLiveUrlAuth": {
      "factors": [
        {
          "password": {
            "value": "system generated password"
          },
          "type": "PASSWORD"
        }
      ]
    }
  }
}
```
공유 대시보드에 대한 비밀번호를 활성화한 후에는 사용자와 비밀번호를 공유해야 합니다. 나중에 비밀번호를 검색할 수 없으므로 비밀번호를 복사하여 저장해 두세요. 비밀번호를 분실한 경우 비밀번호를 재설정한 후 사용자와 다시 공유하기만 하면 됩니다. 비밀번호를 안전하게 관리하려면 비밀번호 관리 모범 사례를 따르세요.

공유 대시보드의 설정을 수정할 수 있는 권한이 있는지 확인하세요. 라이브 대시보드 URL에 대한 비밀번호 보호를 비활성화하려면:

NerdGraph API 탐색기 로 이동합니다.
다음 속성 값을 사용하여 dashboardUpdateLiveUrlAuth 뮤테이션을 사용하여 그래프 API 호출을 구성합니다.

auth > factors > type: 라이브 대시보드 URL에 대한 암호 보호를 활성화하려면 PASSWORD 선택하세요.
id: 공유 대시보드 URL에서 ID를 복사하여 입력합니다.
auth > factors: 이 항목은 비워 두세요.

factors > type: 비밀번호 값이 제거되었다는 확인을 받으려면 이것을 선택하세요.

샘플 돌연변이

mutation {
  dashboardUpdateLiveUrlAuth(
    id: "YOUR_PUBLIC_LINK_UUID"
    auth: { factors: [] } # Send an empty array to remove all authentication
  ) {
    factors {
      # This will be empty
      type
    }
  }
}

샘플 응답

응답이 다음과 같이 나타나는지 확인하세요. 비밀번호가 제거되고 라이브 대시보드 URL은 더 이상 비밀번호로 보호되지 않습니다.

{
  "data": {
    "dashboardUpdateLiveUrlAuth": {
      "factors": []
    }
  }
}

공유 대시보드의 설정을 수정할 수 있는 권한이 있는지 확인하세요. 라이브 대시보드 URL의 비밀번호를 재설정하려면:

NerdGraph API 탐색기 로 이동합니다.
다음 속성 값을 사용하여 dashboardResetLiveUrlPassword 변형을 사용하여 그래프 API 호출을 구성합니다.

id: 공유 대시보드 URL에서 ID를 복사하여 입력합니다.
password: 응답으로 새로운 라이브 대시보드 비밀번호를 받으려면 이것을 선택하세요.
샘플 돌연변이
```
mutation {
  dashboardResetLiveUrlPassword(id: "YOUR_PUBLIC_LINK_UUID") {
    password
  }
}
```
샘플 응답
새로운 비밀번호는 다음과 같이 응답에 표시됩니다.
```
{
  "data": {
    "dashboardResetLiveUrlPassword": {
      "password": "system generated password"
    }
  }
}
```
공유 대시보드의 비밀번호를 재설정한 후에는 새 비밀번호를 사용자와 공유해야 합니다. 나중에 비밀번호를 검색할 수 없으므로 비밀번호를 복사하여 저장해 두세요. 분실한 경우, 다시 재설정하면 됩니다. 비밀번호를 안전하게 관리하려면 비밀번호 관리 모범 사례를 따르세요.

귀하가 보유한 권한 에 따라 귀하가 만든 URL만 취소하거나, 계정의 사용자가 만든 모든 URL을 취소할 수 있습니다. 공유 대시보드 URL을 취소하려면:

NerdGraph API 탐색기 로 이동합니다.
다음 속성 값을 사용하여 dashboardRevokeLiveUrl 변형을 사용하여 그래프 API 호출을 구성합니다.

id: 공유 대시보드 URL에서 ID를 복사하여 입력합니다.
샘플 돌연변이
```
mutation {
  dashboardRevokeLiveUrl(id: "PUBLIC_LINK_ID") {
    id
  }
}
```
샘플 응답
공유 대시보드 URL은 이제 취소되었으며 더 이상 액세스할 수 없습니다. 응답은 다음과 같습니다.
```
{
  "data": {
    "dashboardRevokeLiveUrl": {
      "id": "PUBLIC_LINK_ID" //the one you passed to the mutation
    }
  }
}
```

귀하가 보유한 권한 에 따라 귀하가 만든 URL 목록이나 계정의 사용자가 만든 모든 URL을 검색할 수 있습니다. 공유 대시보드 URL 목록을 가져오려면:

NerdGraph API 탐색기 로 이동합니다.
다음 세부 정보를 사용하여 그래프 API 호출을 구성합니다.

actor > dashboard > liveUrls: 이를 사용하여 공유 대시보드 URL 목록을 검색합니다.
filter > type: 대시보드 URL에 대한 결과를 필터링하려면 DASHBOARD 선택하세요.

응답에 포함할 다른 필드를 선택하세요.

샘플 쿼리

{
  actor {
    user {
      name
    }
    dashboard {
      liveUrls(filter: { type: DASHBOARD }) {
        liveUrls {
          createdAt
          type
          uuid
        }
      }
    }
  }
}

공유 대시보드 URL 목록이 응답으로 나타납니다.

사용자의 편의를 위해 제공되는 기계 번역입니다.

NerdGraph 튜토리얼: 공개 공유 대시보드 URL 생성, 업데이트 및 취소

주의

비밀번호 보호 없이 URL을 생성하세요

샘플 돌연변이

샘플 응답

중요

비밀번호로 보호되는 URL을 만드세요

샘플 돌연변이

샘플 응답

라이브 대시보드 만료 기간 업데이트

샘플 돌연변이

샘플 응답

라이브 URL에 대한 암호 보호 활성화

샘플 돌연변이

샘플 응답

라이브 URL에 대한 비밀번호 보호 비활성화

샘플 돌연변이

샘플 응답

라이브 URL에 대한 비밀번호 재설정

샘플 돌연변이

샘플 응답

라이브 URL 취소

샘플 돌연변이

샘플 응답

모든 공유 URL 나열

샘플 쿼리