---
title: "Pinpoint Cloud を使用する"
slug: "pinpointcloud-use"
tags: ["Pinpoint Cloud"]
updated: 2026-09-17T09:23:26Z
published: 2026-09-17T09:23:26Z
canonical: "guide.ncloud-docs.com/pinpointcloud-use"
---
> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Pinpoint Cloud を使用する
Classic/VPC環境で利用できます。
Pinpoint Cloudウェブコンソールを使用する方法と Pinpoint Agentを使用してアプリケーションを連携する方法を説明します。Pinpoint Cloudウェブコンソールでは、アプリケーションの性能をモニタリングできます。Pinpoint Cloudウェブコンソールは、オープンソースバージョンの Pinpointと同じ UIに構成されているため、既存のユーザーも簡単に適応できます。
## Agentのインストールと管理
Pinpoint Cloudを使用するには、モニタリング対象アプリケーションに Pinpoint Agentをインストールする必要があります。 Pinpoint Agentは、モニタリング対象のアプリケーション(例) Tomcat)に接続した Java Agentで実行されます。Pinpoint Agentをモニタリング対象アプリケーションに接続するには、アプリケーションを実行する際に、`-javaagent` JVM argumentに `$AGENT_PATH/pinpoint-bootstrap-$VERSION.jar`を伝達する必要があります。
### Agentのインストール
Pinpoint Agentをインストールするには、環境変数を設定してリンクを PCにダウンロードする必要があります。インストールする方法は、次の通りです。
1. NAVERクラウドプラットフォームコンソールで、**Menu** > **All Services** > **Management & Governance** > **Pinpoint Cloud**メニューを順にクリックします。
2. リストから希望するリポジトリの **[移動する]** ボタンをクリックします。
3. ウェブコンソールにログインし、右上の をクリックして **Installation**メニューをクリックします。
4. Agentの環境変数を入力します。
- **Application Name**: アプリケーショングループを区分するための IDを入力し、 **[Check]** ボタンをクリック
- **Agent ID**: アプリケーションを区分するための固有 IDを入力し、 **[Check]** ボタンをクリック
5. 入力された情報で JVM argumentが構成されると、をクリックしてコードをコピーします。
- 今後アプリケーションの実行オプションに当該コードを追加してください。
6. **Download Link**にあるリンクをクリックして圧縮ファイルをダウンロードします。
7. ダウンロードした Agentファイルの圧縮を解凍し、モニタリング対象アプリケーションの実行オプション設定とライセンスキー設定を完了します。
```
CATALINA_OPTS="$CATALINA_OPTS -javaagent:$AGENT_PATH/pinpoint-bootstrap-$VERSION.jar"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.agentId=$AGENT_ID"
CATALINA_OPTS="$CATALINA_OPTS -Dpinpoint.applicationName=$APPLICATION_NAME"
```
- モニタリング対象アプリケーションの実行オプション設定: 例) Tomcatの場合、Tomcatの起動スクリプトの `$CATALINA_HOME/bin/catalina.sh`ファイルを以下のように変更して保存します。
- ライセンスキーの設定: **Agent License Key**領域にマウスオーバーすると表示される をクリックしてライセンスキーをコピーし、`$AGENT_PATH/pinpoint.license`ファイルに値を貼り付けて保存します。
8. アプリケーションを実行します。
- インストールした Pinpoint Agentを通じて性能情報が収集されます。
### Pinpointログレベルを調整
Pinpointの各コンポーネントのログレベルを調整するには、`log4j.xml`ファイルを以下のように変更します。
```
(...中略)
(...中略)
```
## 主な機能
Pinpoint Cloudウェブコンソールの主な機能を簡単にご案内します。
参考
Pinpoint Cloudウェブコンソールは、オープンソースバージョンの Pinpointと同じ UIに構成されているため、使用方法に関する詳細は、[Pinpointの公式サイト](https://pinpoint-apm.github.io/pinpoint/main.html)をご参照ください。
### Server Map
分散システムの構成を一目で確認でき、各ノードをクリックして構成要素の現在の状態やトランザクション数などを確認できます。
| 領域 | 説明 |
| --- | --- |
| ① サーバトポロジー | アプリケーションサーバのアーキテクチャ - ユーザーのリクエストで各ノードに向かうトランザクションの数を表示 - ノードを選択すると、チャートで詳細情報を表示 |
| ② Active Request | モニタリング中のアプリケーション内部の有効スレッド数をリアルタイムで表示 |
| ③ チャート | 選択されたノードの詳細情報を分散図と棒グラフで表示 |
### Call Stack
システムトランザクションをコードレベルに確認してボトルネックポイントと障害発生ポイントをスピーディーに識別し、アプリケーションのエラーと例外情報をすぐに確認できます。
Server Mapの分散図に記録されたトランザクションを選択すると、以下のように Call Stack画面が表示されます。
| 領域 | 説明 |
| --- | --- |
| ① トランザクションリスト | 選択したトランザクションリスト - 項目を選択すると、**Call Tree**領域で詳細情報を表示 |
| ② Call Tree | トランザクションを行って実行されたメソッドリスト |
### Application Inspector
アプリケーションのリソースデータ(stat: CPU、メモリ、TPS、Datasource Connection Count)を確認できます。
- チャートで特定領域をドラッグすると、選択された領域のみ拡大して確認できます。
- 拡大された状態で **[Reset Zoom]** ボタンをクリックすると、拡大を解除できます。
## 設定メニュー
Pinpoint Cloudウェブコンソールで をクリックして設定メニューを利用できます。利用可能な設定メニューは次の通りです。
参考
このガイドは、管理者アカウントを基準に表示されるメニューをご案内します。実際アクセスする際にアカウントによっては、一部メニューが表示されない場合があります。
| メニュー | 説明 |
| --- | --- |
| **Administration** | リポジトリ別のウェブコンソールユーザーと Agentデータ管理 - **Users**: ユーザーのアカウント追加/変更/削除([ユーザー管理](/docs/ja/pinpointcloud-use#%EC%82%AC%EC%9A%A9%EC%9E%90%EA%B4%80%EB%A6%AC)を参照) - **Role**: ユーザーに付与するロールと権限設定([ロール管理](/docs/ja/pinpointcloud-use#%EC%97%AD%ED%95%A0%EA%B4%80%EB%A6%AC)を参照) - **Agent Statistic**: Agent統計情報を照会 - **Agent Management**: Agentに登録されたアプリケーションを確認/削除 |
| **Setting** | リポジトリ別のウェブコンソール使用設定**General**: Server Mapの表記カテゴリ、時間帯、時間表示形式、言語設定**Favorite List**: アプリケーションをお気に入りに登録/削除**User Profile**: アカウント情報変更 |
| **User Group** | ユーザーグループの追加と管理([ユーザーグループ管理](/docs/ja/pinpointcloud-use#%EC%82%AC%EC%9A%A9%EC%9E%90%EA%B7%B8%EB%A3%B9%EA%B4%80%EB%A6%AC)を参照) |
| **Authentication & Alarm** | ユーザーグループ別アプリケーションの使用権限と通知設定([アプリケーションの使用権限と通知設定](/docs/ja/pinpointcloud-use#%EC%95%A0%ED%94%8C%EB%A6%AC%EC%BC%80%EC%9D%B4%EC%85%98%EC%82%AC%EC%9A%A9%EA%B6%8C%ED%95%9C%EB%B0%8F%EC%95%8C%EB%A6%BC%EC%84%A4%EC%A0%95)を参照) |
| **Installation** | Agentインストールの環境変数設定とダウンロード([Agentインストール](/docs/ja/pinpointcloud-use#Agent%EC%84%A4%EC%B9%98)を参照) |
### ユーザー管理
作成されたリポジトリウェブコンソールのユーザーを管理できます。
#### ユーザーの追加
新しいユーザーを追加する方法は次の通りです。
1. Pinpoint Cloudウェブコンソールで ** > Users**メニューを順にクリックします。
2. ユーザーリスト上部の をクリックします。
3. ユーザー情報を入力し、 **[保存]** ボタンをクリックします。
- ユーザーロールは、**Role**メニューで設定できます。新しいロールを作成するには、[ロール作成](/docs/ja/pinpointcloud-use#%EC%97%AD%ED%95%A0%EC%83%9D%EC%84%B1)をご参照ください。
参考
登録されたユーザー情報を変更するには、リストでユーザーをクリックしてから入力欄に情報を新しく入力し、 **[保存]** ボタンをクリックします。
#### ユーザーの削除
ユーザーを削除する方法は、次の通りです。
1. Pinpoint Cloudウェブコンソールで ** > Users**メニューを順にクリックします。
2. ユーザーリストで削除するユーザーの をクリックします。
3. **[削除]** ボタンをクリックします。
### ロール管理
リポジトリウェブコンソールユーザーのロールと使用権限を管理できます。
#### ロール作成
新しいロールの作成方法は次の通りです。
1. Pinpoint Cloudウェブコンソールで ** > Role**メニューを順にクリックします。
2. ロールリスト上部の をクリックします。
3. ロール名を入力し、付与する使用権限を選択した後、 **[保存]** ボタンをクリックします。
参考
登録されたロール情報を変更するには、リストでロールをクリックしてから使用権限を選択し、 **[保存]** ボタンをクリックします。
#### ロール削除
ロールを削除する方法は、次の通りです。
参考
ロールを削除すると、当該ロールに指定されたユーザーの使用権限が一緒に削除されます。
1. Pinpoint Cloudウェブコンソールで ** > Role**メニューを順にクリックします。
2. ロールリストで削除するロールの をクリックします。
3. **[削除]** ボタンをクリックします。
### ユーザーグループ管理
登録されたユーザーをグループ化して使用できるアプリケーションを指定し、通知対象者として一括設定できます。
#### ユーザーグループの照会
ユーザーグループのリストとグループ別に設定された詳細情報を照会できます。ユーザーグループを照会する方法は、次の通りです。
1. Pinpoint Cloudウェブコンソールで ** > User Group**メニューを順にクリックします。
2. User Group画面でグループ情報を確認します。
- **User Group**: 作成されたユーザーグループリスト
- リスト内の項目をクリックすると、当該グループに属したメンバーリストが **Group Member**に表示されます。
- をクリックして新しいユーザーグループを作成できます。
- をクリックしてユーザーグループを削除できます。
- **Group Member**: 選択されたグループに属するメンバーリスト
-  **>** をクリックしてメンバーをグループから削除できます。
- **Pinpoint User**: Pinpoint Cloudウェブコンソールに登録されているすべてのユーザーリスト
- グループが選択された状態でユーザー名の前にあるチェックボックスをクリックして選択すると、当該ユーザーがグループメンバーに追加されます。
- ユーザー名をクリックすると、プロファイルの詳細情報が確認できます。
- **Application Authentication & Alarm**: 選択されたグループに指定されたアプリケーションリスト
- **Detail**項目の をクリックしてアプリケーションの使用権限を確認できます。
- **More**項目の をクリックして **Authentication & Alarm**メニューに移動できます。
#### ユーザーグループの作成
新しいユーザーグループを作成してメンバーを追加する方法は次の通りです。
1. Pinpoint Cloudウェブコンソールで ** > User Group**メニューを順にクリックします。
2. **User Group**リスト上部の をクリックします。
3. ユーザーグループ名を入力し、 **[OK]** ボタンをクリックします。
4. 作成されたユーザーグループをクリックし、**Pinpoint User**リストでメンバーとして追加するユーザーのチェックボックスをクリックして選択します。
- 選択されたユーザーが **Group Member**リストに追加されます。
### アプリケーションの使用権限と通知設定
Pinpoint Cloudウェブコンソールに登録されたアプリケーションの使用権限をユーザーグループに付与し、イベントの発生時に送る通知を設定できます。
#### 使用権限設定
アプリケーションの使用権限を設定してユーザーグループに付与する方法は、次の通りです。
1. Pinpoint Cloudウェブコンソールで ** > Authentication & Alarm**メニューを順にクリックします。
2. **Application**リストで使用権限を付与するアプリケーションをクリックします。
3. **Authentication**リスト上部の をクリックします。
4. 使用権限を付与するユーザーグループ IDとポジションを選択してからデータの表示有無を設定し、 **[OK]** ボタンをクリックします。
- 権限設定内容がリストに追加されます。
- をクリックしてユーザーグループに設定されたデータの表示有無を確認できます。
- をクリックしてポジションとデータの表示有無を変更できます。
-  **>** をクリックして権限設定内容を削除できます。
#### 通知設定
指標の基準を超えると、SMS/メールに通知を送るように設定できます。通知設定が可能な指標項目は、次の通りです。
| 項目 | 説明 |
| --- | --- |
| SLOW COUNT | 外部からアプリケーションを呼び出したリクエストの中で、外部サーバに遅れてレスポンスしたリクエストの数がしきい値を超えた場合、通知送信 |
| SLOW RATE | 外部からアプリケーションを呼び出したリクエストの中で、外部サーバに遅れてレスポンスしたリクエストの比率(%)がしきい値を超えた場合、通知送信 |
| ERROR COUNT | 外部からアプリケーションを呼び出したリクエストの中で、エラーが発生したリクエストの数がしきい値を超えた場合、通知送信 |
| ERROR RATE | 外部からアプリケーションを呼び出したリクエストの中で、エラーが発生したリクエストの比率(%)がしきい値を超えた場合、通知送信 |
| TOTAL COUNT | 外部からアプリケーションを呼び出したリクエストの数がしきい値を超えた場合、通知送信 |
| SLOW COUNT TO CALLEE | アプリケーション内で外部サーバを呼び出したリクエストの中で、遅れてレスポンスした呼び出しの数がしきい値を超えた場合、通知送信。メモ項目に外部サーバのドメインやアドレス(IP、ポート)を入力する必要がある 例) naver.com、127.0.0.1:8080 |
| SLOW RATE TO CALLEE | アプリケーション内で外部サーバを呼び出したリクエストの中で、遅れてレスポンスした呼び出しの比率(%)がしきい値を超えた場合、通知送信。メモ項目に外部サーバのドメインやアドレス(IP、ポート)を入力する必要がある 例) naver.com、127.0.0.1:8080 |
| ERROR COUNT TO CALLEE | アプリケーション内で外部サーバを呼び出したリクエストの中で、エラーが発生した呼び出しの数がしきい値を超えた場合、通知送信。メモ項目に外部サーバのドメインやアドレス(IP、ポート)を入力する必要がある 例) naver.com、127.0.0.1:8080 |
| ERROR RATE TO CALLEE | アプリケーション内で外部サーバを呼び出したリクエストの中で、エラーが発生した呼び出しの比率(%)がしきい値を超えた場合、通知送信。メモ項目に外部サーバのドメインやアドレス(IP、ポート)を入力する必要がある 例) naver.com、127.0.0.1:8080 |
| TOTAL COUNT TO CALLEE | アプリケーション内で外部サーバを呼び出したリクエストの数がしきい値を超えた場合、通知送信。メモ項目に外部サーバのドメインやアドレス(IP、ポート)を入力する必要がある 例) naver.com、127.0.0.1:8080 |
| HEAP USAGE RATE | heapの使用率がしきい値を超えた場合、通知送信 |
| JVM CPU USAGE RATE | アプリケーションの CPUの使用率がしきい値を超えた場合、通知送信 |
| SYSTEM CPU USAGE RATE | サーバの CPUの使用率がしきい値を超えた場合、通知送信 |
| DATASOURCE CONNECTION USAGE RATE | アプリケーション datasource内の connection使用率がしきい値を超えた場合、通知送信 |
| DEADLOCK OCCURRENCE | アプリケーションでデッドロックを検知すると、通知送信 |
| FILE DESCRIPTOR COUNT | 開いている file descriptorの数がしきい値を超えた場合、通知送信 |
イベント発生時、ユーザーグループに送る通知を設定する方法は、次の通りです。
1. Pinpoint Cloudウェブコンソールで ** > Authentication & Alarm**メニューを順にクリックします。
2. **Alarm**リスト上部の をクリックします。
3. 通知項目としきい値を設定してから通知を受けるユーザーグループ IDと通知形式を選択し、 **[OK]** ボタンをクリックします。
- 通知内容がリストに追加されます。
- をクリックして通知内容を変更できます。
-  **>** をクリックして通知内容を削除できます。