ノートブック

概要

ノートブックは、グラフとテキストを組み合わせて 1 列のセル形式で表示し、事後分析、調査、ランブック、ドキュメントなどを作成することで、データの背景情報を調査したり共有したりできます。

はじめに

Notebook List ページで、+ New Notebook をクリックします。
Save Notebook ボタンをクリックします。
注: 新しいノートブックは、デフォルトでは保存されません。
サポートされているグラフやテキストコンテンツを使って、ノートブックに新しいセルを追加します。
セルを構成します。

コラボレーション

ユーザーがノートブックを閲覧し、ライブエディットを行っていることを示すインジケーター

ノートブックは、リアルタイムのコラボレーションをサポートします。プレゼンスインジケーターは、ノートブックを誰が見ているか、またノートブックのセルをリアルタイムで編集しているかを表示します。ノートブックに加えられた変更は、更新することなく、自動的に表示されます。

チームの誰もが任意のノートブックを開くことができますが、ノートブックを変更または削除できるのは、Notebooks Write 権限を持つ Datadog ロールに限られます。

コメントの作成

コメントを追加するには、テキストを選択するか、グラフにカーソルを合わせます。セルの右側に Add comment のアイコンが表示されます。コメントから、@mention 機能でチームのメンバーに通知することもできます。書いたコメントを編集したり削除したりするには、コメントの右上にある 3 つの縦長の点をクリックします。解決したコメントは、ノートブックの歯車メニューにある Comment History サイドパネルで表示したり、再度開いたりすることができます。

ノートブックへ新規コメントがあると、ノートブックの作成者に通知が送信され、コメントに返信があるとコメントの作成者に通知が送信されます。通知設定を管理するには、ノートブックのメニュー（歯車）にある Notifications を使用します。

ビューモード

ノートブックの右上にあるドロップダウンを選択することで、ノートブック内からモードを切り替えることができます。

Editing: ノートブックに変更を加えます。
Viewing: コンテンツは読み取り専用で、既存の構成や情報をユーザーが不要に編集することを防ぎます。
Presenting: 各セルがスライドとして表示される表示形式で、ノートブックの内容を共有します。プレゼンテーションモードでは、ツールチップや凡例などのグラフのインタラクションをサポートしています。

ノートブックの共有

ノートブックの右上にある歯車のアイコンをクリックすると、共有オプションが表示されます。ノートブックは、PDF、Markdown などのドキュメントエディタにエクスポートできます。

ノートブックをドキュメントエディタにコピーするには、Copy formatted contents をクリックします。Google ドキュメントや Microsoft Word などのドキュメントエディタに貼り付けて、グラフを含むノートブックのコンテンツを元の形式で表示します。

ノートブック JSON のインポートまたはエクスポート

ノートブックの定義を含む JSON ファイルをダウンロードするには、Export Notebook JSON を使用します。Import Notebook JSON を使用すると、ノートブックのすべてのコンテンツがアップロード済みの JSON コンテンツで上書きされます。

個々のセルへのリンク設定

特定のセルの URL をコピーするには、セルの Share メニューをクリックし、Link directly to cell を選択します。直接リンクは、視覚化セルとマークダウンセルの両方で利用できます。

ユーザーが特定のセルの URL にアクセスすると、ノートブックが開き、ビューポートの上部にセルが表示されます。絶対リンクのため、セルの URL はノートブック内で新しい位置に移されたとしても、変わることはありません。

ノートブックに画像を追加する

ファイル形式は PNG、JPG、JPEG、GIF のみ対応しており、アップロードの最大ファイルサイズは 4MB です。

ノートブックに画像を追加するには、イメージセルまたは Markdown エディタのいずれかを使用します。

イメージセル

この方法では、画像をテキストとは別のセルに配置し、サイズ変更、整列、キャプションの追加が可能です。イメージセルでアップロードされた画像は Datadog によってホストされます。

画像を追加するには、Add New Cell メニューの Image セルオプションをクリックします。

Datadog にホストする画像をアップロードするには、以下のいずれかの方法を使用します。

アップロード領域に画像ファイルをドロップします。
Choose File をクリックし、ファイルディレクトリから画像を選択します。
画像の公開 URL を貼り付けます。

セルのアクショントレイにあるアイコンをクリックして、サイズや配置を調整したり、キャプションを追加したり、フルスクリーンモードで画像を表示したりします。

Markdown エディタ

この方法では画像はテキストとインラインで配置されますが、画像のサイズを変更するオプションはありません。

任意の Markdown セルの編集モードに入り、以下のいずれかの方法で画像を追加します。

画像ファイルをテキストセル領域にドロップします。
画像をコピーしてテキストセル領域に直接貼り付けます。
ヘッダーの画像ウィジェットを使用するか、公式 Markdown ガイドを参照して外部画像をハイパーリンクします。注: この方法では Datadog にホストする画像をアップロードしません。

画像をノートブックに保存する前に、Preview タブで画像を確認できます。

ノートブック一覧

ノートブック一覧で、以前に作成したノートブックの表示と検索ができます。各ノートブックの名前、作成者、最終更新日が表示されます。ノートブックは以下のグループに分けられます。

Your Notebooks: 自分が作成したノートブック。
All Notebooks: 組織内のすべてのノートブック。
Notebook Type: ノートを種類別に分類します。

任意のノートブックのプレビューアイコンにカーソルを合わせると、ウィジェットタイプや Markdown を含むコンテンツのプレビューが表示されます。ビューモードでノートブックを開くには、ノートブックにカーソルを合わせ、右側にある Open notebook in view mode をクリックします。

テンプレートギャラリー

テンプレートギャラリーでは、新しいノートブックを作成するための、すぐに使えるテンプレートが紹介されています。テンプレートには、インシデントレスポンスのポストモーテム、インシデントレポート、SLO 仕様が含まれます。また、新しいカスタムテンプレートを作成し、再利用可能なノートブック構造を構築することもできます。

バージョン履歴

ノートブックから ** Configure** アイコンをクリックし、Version history をクリックすると、バージョン履歴のサイドパネルが表示されます。ノートブックのバージョン履歴をプレビューしたり、復元したり、複製したりすることができます。詳しくは、バージョン履歴ガイドを参照してください。

ノートブックの構成

タイムフレーム

デフォルトでは、すべてのグラフセルはノートブックのヘッダに設定されたグローバルなタイムフレームにリンクされています。

別のタイムフレームを表示するには、グローバルタイムピッカーでオプションを選択するか、グラフを直接スクラブします。ノートブック URL は、ノートブックに保存することなく、この新しいタイムフレームを反映するように更新されます。

注: クリックアンドドラッグしてグラフを拡大しても、セルのグローバルな時間を解除することはできません。この操作を行うと、ノートブックのグローバルなタイムフレームが変更されます。

Set Default Time ボタンでノートブックのグローバルタイムを保存する

この時間をノートブックのデフォルトとして保存するには、Set Default Time をクリックします。グローバルタイムを、以前に保存したデフォルトのグローバルタイムに戻すには、リセットボタンをクリックします。

個々のセルは、グローバルタイムのリンクを解除し、独立したタイムフレームを設定することができます。

1 つのセルで別のタイムフレームを表示するには、そのセルを編集し、トグルを使用しグローバルタイムからリンクを解除します。タイムピッカーを使用するかグラフをスクラブして、タイムフレームを変更します。編集モードでの変更は、Done をクリックすると自動的に保存されます。変更内容を破棄するには、Done ではなく Cancel をクリックします。

ノートブックタイプ

ノートブックをタイプ別に分類することで、関連する情報に素早くアクセスすることができます。インシデント管理やモニターなど、他の製品から構築されたノートブックには、自動的にタイプが割り当てられる場合があります。ノートブックのタイトルにカーソルを合わせると、タイプを追加または編集するためのオプションが表示されます。または、カーソルを合わせて表示される鉛筆のアイコンをクリックすると、タイプを編集することができます。

グラフのスナップショット

ノートブックでは、期限切れになる可能性のあるグラフのスナップショットを自動的に取るように設定することができます。ノートブックの歯車メニューの Turn on snapshots をクリックして、この機能を有効にします。歯車メニューを使用して、スナップショットを表示したり、自動スナップショットをオフにしたりすることができます。自動スナップショットをオフにすると、既存のスナップショットへのアクセスが削除されます。

スナップショットが有効になっているノートブックは、固定の時間範囲 (たとえば Aug 18, 12:00 am - Aug 19, 11:59 pm) でグラフの静止画像を自動的にキャプチャします。このスナップショットは、新しいグラフに同じ時間範囲が設定されていれば、グラフの更新に合わせて更新されます。グラフをグローバルな時間範囲 (Past 1 Hour など) に変更すると、スナップショットは削除されます。

固定時間のグラフの既存のスナップショットをプレビューするには、編集モードでカメラアイコンの上にカーソルを合わせます。

スナップショット付きのノートブックのバージョンを共有するには、歯車メニューから、View snapshots をクリックします。URL をコピーするか、スナップショットを有効にしているノートブックの URL に &view=snapshots を追加します。

テンプレート変数

ノートブックはテンプレート変数をサポートしています。テンプレート変数の値を追加・選択することで、視覚化した内容を動的にスコープすることができます。詳しくは、テンプレート変数を参照してください。

セルの構成

セルを追加するには、セルの左に表示される + ボタンを使用するか、ノートブックの下部にある Add New Cell のセクションからオプションを選択します。セルを共有、複製、削除するには、カーソルを置いたときにセルの上に表示されるアクショントレイを使用します。グラフセルは、ダッシュボードにエクスポートしたり、PNG やグラフデータの CSV としてダウンロードすることができます。編集モードでの変更は、Done をクリックすると自動的に保存されます。変更内容を破棄するには、Done ではなく、Cancel をクリックしてください。

オプションの編集

ウィジェットのインラインエディターで More options をクリックすると、ウィジェットのオプションが編集できます。イベントオーバーレイ、マーカー、Y 軸コントロールなどの詳細を追加します。

レイアウトオプション

ノートブックのセルで、Edit をクリックすると、セルの構成が編集モードで表示されます。また、利用可能なレイアウトオプションを見ることができます。レイアウトオプションは、セルのコンテンツタイプによって異なりますが、以下のようなものがあります。

グラフサイズ: XS、S、M (デフォルト)、L、XLから選択。
グラフの凡例: 凡例を非表示にするには、ボックスのチェックマークを外します。XS と S サイズのグラフでは、凡例は自動的に無効になります。
グループ化: タグ値ごとに 1 つのグラフを表示し、複数の小さいグループに視覚化します。

グラフサイズ、凡例、グループ化構成のレイアウトオプションを表示する編集モードのノートブックセルのグラフ設定オプション

注: 設定の変更は対象となるセルにのみ影響します。

コンテンツの種類

ノートブックは、視覚化とテキストセルをサポートしています。テキストセルは Markdown でフォーマットされ、見出し、小見出し、リンク、イメージ、リスト、コードブロックを使用することが可能です。また、ノートブックでは、MermaidJS でフォーマットされたダイアグラムもサポートしています。

ノートブック内のグラフは、Datadog のすべてのデータソースに対応しています（メトリクス、ログイベント、インデックス化されたスパン、ライブプロセス、ネットワークトラフィック、RUM イベント、プロファイリングのメトリクス、セキュリティシグナルなど）。グラフは、Datadog のクエリエディターで作成します。ノートブックは以下に対応しています。