ノートブックは共同作業用に設計されています。データを基にしたドキュメントをチームメンバーと簡単に共有して、洞察の共有、調査への共同参加、再利用可能な分析テンプレートの作成を行うことができます。
ノートブック共有の概要
New Relic組織内で作成されたすべてのノートブックは、ノートブック機能にアクセスできる他の組織メンバーに自動的に利用可能になります。これにより、チーム全体でシームレスなコラボレーションが可能になります。
重要
現在、ノートブックには詳細な権限設定はありません。組織内でノートブック機能にアクセスできるユーザーは誰でも、任意のノートブックを表示、編集、削除できます。今後のリリースでは、より詳細な権限を導入する予定です。
ノートブックのURLを共有する
特定のノートブックを共有する最も簡単な方法は、そのURLを共有することです。
- 共有したいノートブックを開きます。
- browserのアドレスバーからURLをコピーします。
- メール、チャット、またはお好きなコミュニケーションツールを使用して、チームメンバーとURLを共有します。
チームメンバーがそのURLをクリックすると、直接ノートブックに移動します(New Relic組織へのアクセス権がある場合)。
共有ノートブックを見つける
チームメンバーが作成したノートブックを見つけるには:
- one.newrelic.comに移動します。
- データのクエリコンソールを開きます。
- Notebooksをクリックすると、ノートブックのインデックスが表示されます。
- 組織内のすべてのノートブックを参照するか、検索機能を使用して特定のノートブックを見つけます。
ノートブックを検索する
ノートブックインデックスの検索バーを使用して、次の条件で特定のノートブックを検索します。
- ノートブック名
- ノートブックタイトルのキーワード
- ノートブック内のコンテンツ(検索可能な場合)
ノートブックを並べ替える
ノートブックのリストを次の基準で並べ替えます。
- 名前:アルファベット順
- 最終更新日:最近更新されたものから順に
- 作成日:新しい順または古い順
- お気に入り:スターを付けたノートブックを上部に表示
コラボレーションのベストプラクティス
命名規則
チームメンバーがノートブックの目的を理解できるように、ノートブックには明確で分かりやすい名前を使用します。
- 良い例:「APIパフォーマンス調査 - 2024年10月」
- 良い例:「週次エラー率分析テンプレート」
- 良い例:「顧客離脱分析 - 第3四半期の結果」
- 悪い例:「マイノートブック」または「テスト」
組織戦略
テンプレートを作成する
一般的な分析タスク用に再利用可能なノートブックテンプレートを構築します。
- 標準的なクエリと構造を持つノートブックを作成する
- カスタマイズ可能な要素には変数を使用する
- チームメンバー向けにMarkdownで指示を追加する
- テンプレートとして明確な名前を付ける(例:「テンプレート:インシデント調査」)
分析を文書化する
Markdownブロックを使用して、コンテキストを提供します。
- 各クエリの目的を説明する
- 分析方法を文書化する
- 関連リソースへのリンクを含める
- 結論と次のステップを追加する
分かりやすい視覚化を使用する
- チャートにわかりやすいタイトルを追加する
- 一貫した配色を使用する
- 軸ラベルと単位を含める
- 必要に応じて閾値またはベースライン指標を追加する
共同ワークフロー
インシデント対応
共同でインシデント調査を行うノートブックを作成します。
- 標準的なインシデントテンプレートから始める
- 調査の進行に応じてチームメンバーを追加する
- Markdownブロックを使用して調査結果をリアルタイムで文書化する
- 関連するクエリと視覚化を含める
- 根本原因と修復手順をまとめる
週次/月次レポート
定期的な分析ノートブックを作成します。
- 標準メトリクスを含むノートブックテンプレートを作成する
- 時間範囲やフィルターには変数を使う
- チームで定期的なレビューをスケジュールする
- 完了したレポートを日付固有の名前でアーカイブする
知識の共有
一度限りの調査を再利用可能な知識に変換します。
- 詳細な分析ノートブックを作成する
- Markdownに方法論と根拠を含める
- 異常な発見を説明するコメントを追加する
- 今後の参考のためにチーム全体と共有する
バージョン管理と履歴
ヒント
現在、ノートブックにはバージョン履歴が組み込まれていません。大幅な変更を行う前に、重要なノートブックを複製して以前のバージョンを保存することを検討してください。
バージョン管理を維持するには:
- 大きな変更の前に複製する:大きな変更を加える前にノートブックのコピーを作成する
- 使いやすい名前を使用する:ノートブック名にバージョン番号や日付を含める
- ドキュメントの変更:Markdownブロックを使用して、何がいつ変更されたかを記録する
- 古いバージョンをアーカイブする:古いバージョンを別のフォルダー、または命名規則に従って移動する
共有に関する問題のトラブルシューティング
ノートブックがチームメンバーに表示されない
チームメンバーにノートブックが表示されない場合:
- 組織アクセスの確認:同じNew Relic組織に属していることを確認する
- 機能アクセスの確認:ノートブックのプレビュー機能にアクセスできることを確認する
- 直接URLを試す:インデックスから見つけてもらうのではなく、特定のノートブックURLを共有する
共有ノートブックのパフォーマンス
大規模または複雑なノートブックは、すべてのユーザーに対して読み込みが遅くなる可能性があります。
- クエリの最適化:適切な時間範囲とフィルターを使用する
- 結果セットを制限する:NRQLで
LIMIT句を使用する - 分割を検討する:非常に大きなノートブックを、焦点を絞った小さなドキュメントに分割する
次は何ですか?
- ノートブックの視覚化について学ぶ
- コラボレーションのヒントとなるノートブックの例を見る
- 高度なテクニックについては、ノートブックにクエリを追加する方法をご覧ください