---
title: "JSSアプリにおけるデバッグログ"
slug: "debug-logging-in-jss-apps"
abstract: "開発者体験と本番デバッグのデバッグを強化するために、JSSデバッグログを活用しましょう"
---
# JSSアプリにおけるデバッグログ

Sitecore JSS NPMパッケージやサンプルは [デバッグモジュール](https://www.npmjs.com/package/debug) を使ってデバッグ情報を出力します。

このモジュールはdebug() 関数を公開しており、これはconsole.log() 文の拡張版です。console.logとは異なり、本番コードではコメントアウトやdebug() 呼び出しを削除する必要がなく、環境変数を使って必要に応じて本番環境でデバッグログを簡単に有効化できます。

すべてのSitecore JSSログはルート名前空間sitecore-jssのもとで整理されています。ログはデフォルトでオフにされており、DEBUG環境変数を使って条件付きでオンにすることができます。

> !注デバッグログにはサーバー側のコードのみが含まれているため、[ブラウザでデバッグログを有効にし](https://www.npmjs.com/package/debug#browser-support)てもメリットはありません。

利用可能なすべてのデバッグログを出力するには、DEBUG環境変数をsitecore-jss:\*に設定します。アスタリスク(\*)はワイルドカードとして使われます。

DEBUG=sitecore-jss:\*

例えばレイアウトサービスログなど、特定のログメッセージカテゴリのみを選択的に表示することもできます。

DEBUG=sitecore-jss:layout

または、レイアウトサービスログ以外のすべてを表示するには、\- プレフィックスを使うことができます:

DEBUG=sitecore-jss:\*,-sitecore-jss:layout

## 名前空間

以下の表は利用可能なすべての名前空間と、該当するSitecore JSS npmパッケージおよびサンプルアプリケーションを一覧にしています。

名前空間

パッケージ/サンプルアプリ

概要

sitecore-jss:http

sitecore-jss,nextjs

デフォルトのフェッチラッパー(GraphQLRequestClientおよびAxiosDataFetcher)に対するHTTPリクエストおよびレスポンスログです。

sitecore-jss:dictionary

sitecore-jss、nextjs、 node-headless-ssr-experience-edge

辞書サービス実装(GraphQLDictionaryServiceおよびRestDictionaryService)のためのトレースログ。

sitecore-jss:layout

sitecore-jss、nextjs、node-headless-ssr-experience-edge

レイアウトサービス実装のためのトレースロギング(GraphQLLayoutServiceおよびRestLayoutService)。

sitecore-jss:editing

sitecore-jss-nextjs,nextjs

Sitecoreエディタ統合のためのNext.jsミドルウェアのトレースログ。

sitecore-jss:sitemap

sitecore-jss-nextjs、nextjs、 nextjs-sxa

サイトマップサービス(GraphQLSitemapService)およびヘッドレスSXA sitemap.xmlサービス(GraphQLSitemapXmlService)Next.js GraphQLトレースログ。

sitecore-jss:robots

sitecore-jss-nextjs、nextjs、 nextjs-sxa

ヘッドレスSXA robots.txtサービス(GraphQLRobotsService)Next.jsトレースログ。

sitecore-jss:redirects

sitecore-jss-nextjs、nextjs、 nextjs-sxa

ヘッドレスSXAのトレースログNext.jsミドルウェア(RedirectsMiddleware)をリダイレクトします。

sitecore-jss:errorpages

sitecore-jss-nextjs、nextjs、 nextjs-sxa

ヘッドレスSXAエラーページサービス(GraphQLErrorPagesService)Next.jsトレースログ。

sitecore-jss:multisite

sitecore-jss、 sitecore-jss-nextjs、 nextjs、 nextjs-multisite

サイト情報サービス(GraphQLSiteInfoService)とマルチサイトミドルウェアGraphQL Next.jsトレースログ(MultisiteMiddleware)。

## 高度なオプション

Node.jsで動作する際、以下の環境変数を使ってデバッグログの挙動を変える追加の環境変数をいくつか設定できます:

名称

概要

DEBUG

特定のデバッグ名片を有効化・無効化します。

DEBUG\_HIDE\_DATE

デバッグ出力から日付を非表示(非TTY)してください。  
  
デフォルト: false

DEBUG\_COLORS

デバッグ出力で色を使うかどうか。  
  
デフォルト: true

DEBUG\_DEPTH

物体検査の深度。  
  
デフォルト:2

DEBUG\_MULTILINE

プリティープリントは複数の線でオブジェクトを検査しました。  
  
デフォルト:false(単一行)

DEBUG\_SHOW\_HIDDEN

検査対象の隠れた特性を表示します。  
  
デフォルト: false