[Android Studio]デバッグログの出し方(Log.dの書き方とLogcatでの絞り込み方)

このページには広告が含まれる場合があります。

 

この記事は2017年に書いたものを、2026年11月に今のやり方に合わせて書き直しました(2026年11月21日時点の情報。公式ドキュメントで確かめています)。

Android Studio でデバッグログを出すには、プログラムの中に Log クラス でタグとメッセージを書き、アプリを動かして Logcat の画面で見ます。

Log.d("MainActivity", "ボタンが押されました")

この1行を書いておくと、そこを通ったときに Logcat に「ボタンが押されました」と出ます。

「ちゃんとここまで来てるんかな?」を確かめたいときに、いちばん手軽な方法なんです。

Log クラスの書き方は、2017年に元の記事を書いたころから変わっていません。大きく変わったのは、ログを見る Logcat の画面と、絞り込みの仕方です。

 

Log クラスの書き方

1. TAG を決めておく

公式のリファレンスでは、クラスの中に TAG(タグ)の定数を1つ作り、それを毎回使う書き方がすすめられています。

Kotlin なら、たとえばこう書きます。

import android.util.Log

class MainActivity : AppCompatActivity() {

    companion object {
        private const val TAG = "MainActivity"
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Log.d(TAG, "onCreate が呼ばれました")
    }
}

タグは、あとで Logcat で絞り込むときの目印になります。

クラスの名前にしておくと、どの画面から出たログかがすぐわかります。

なお、Android 7.1(API 25)までの端末では、タグが23文字を超えると isLoggable で例外になることがあると、リファレンスに書かれています。古い端末でも動かすなら、タグは短めにしておくと安心です。

2. 5つの種類を使い分ける

ログには重さ(優先度)の段があり、メソッドの名前で分けます。

メソッド種類使いどころの例
Log.v()VERBOSE(詳細)細かい動きを全部追いたいとき
Log.d()DEBUG(デバッグ)値の中身や、処理が通ったかを確かめるとき
Log.i()INFO(情報)「読み込みが終わった」など、節目を残したいとき
Log.w()WARN(警告)動きは続くが、おかしな値が来たとき
Log.e()ERROR(エラー)失敗したとき・例外を受けたとき

このほかに Log.wtf()(What a Terrible Failure。起きてはいけないことが起きたとき)があり、ASSERT の段で記録されます。

例外を受けたときは、3つ目の引数に例外を渡すと、スタックトレース(どの行で起きたかの記録)も一緒に出ます。

try {
    val n = text.toInt()
    Log.d(TAG, "入力された数は $n")
} catch (e: NumberFormatException) {
    Log.e(TAG, "数に変換できませんでした: $text", e)
}

Java の場合も、書き方は同じです(Log.d(TAG, "メッセージ");)。

ログは、文法エラーではないのに思った動きにならない「論理エラー」を探すときに、特に役に立ちます。

(エラーの種類については、こちらの記事でも書いていますので、よろしければご覧ください)

 

今の Logcat でログを見る

Logcat は、Android Studio Dolphin(2021.3.1、2022年)で新しい画面に変わりました。今の開き方と見方は次のとおりです。

  1. Android Studio で、アプリをエミュレーターか実機で動かす
  2. メニューの View → Tool Windows → Logcat を選ぶ
  3. 上の検索の欄(クエリの欄)に、絞り込みの条件を入れる

何も絞り込まないと、端末のシステムのログまで全部流れてきます。

「自分のログ、どこに出てんねん?」となったら、まず絞り込みを入れてみてください。

よく使う絞り込みの書き方

検索の欄には「キー:値」の形で書きます。欄の中で Ctrl + Space を押すと、書ける候補が出ます。

書き方意味
package:mine今開いているプロジェクトのアプリのログだけ
tag:MainActivityタグに「MainActivity」を含むログだけ
level:WARNWARN 以上(WARN・ERROR・ASSERT)だけ
message:ボタンメッセージに「ボタン」を含むログだけ
-tag:MainActivityタグに「MainActivity」を含むログを除く
tag~:Main.*タグを正規表現で探す
age:5mここ5分のログだけ
is:crashアプリが落ちたときのログだけ

組み合わせるときは、スペースで並べます。

package:mine tag:MainActivity level:DEBUG

これで「自分のアプリの、MainActivity のタグの、DEBUG 以上のログ」だけが出ます。

公式ドキュメントでは、同じキーを並べたとき(tag:foo tag:bar)は「どちらか」、違うキーを並べたときは「どちらも」として扱う、と説明されています。&(かつ)・|(または)・かっこも使えます。

level は「その段以上」を出す決まりなので、level:DEBUG にすると VERBOSE だけが外れます。

見やすくする設定

  • 1行が長いときは、Logcat のツールバーの Soft-Wrap で折り返せる
  • 日付やプロセス ID などが多すぎるときは、ツールバーの書式のボタン(Configure Logcat Formatting Options)から Compact の表示に切り替えられる
  • 新しい Logcat の窓を開いたときの最初の絞り込みは、Settings → Tools → Logcat で変えられる(Mac は Android Studio → Settings、Windows は File → Settings)
  • タブを増やしたり、画面を左右・上下に分けたりして、別の絞り込みを並べて見ることもできる

アプリが落ちて立ち上がり直すと、Logcat に PROCESS ENDED・PROCESS STARTED と出ます。落ちる直前のログも流れずに残るので、is:crash と合わせて原因を探せます。

ログで当たりをつけたら、ブレークポイントで止めて変数の中身を見る方法も合わせて使うと、原因にたどり着きやすくなります。

(デバッグモードの使い方は、こちらの記事でも書いていますので、よろしければご覧ください)

 

リリースの前にはログを外す

公式ドキュメントの「リリースの準備」には、リリース用にビルドする前にログを止めること、そのやり方として、ソースの中の Log の呼び出しを消すことが書かれています。

同じページには、アプリを小さくする設定(shrinking)を使い、ProGuard のルールでログの文を取り除く手もある、と書かれています。ルールの書き方は、使っている設定によって異なります。

パスワードや個人の情報をログに出していると、そのまま残ってしまうこともあるので、リリースの前に一度見直しておくと安心です。

 

Flutter のアプリの場合

Flutter で Android 向けのアプリを作っている場合は、Dart の側では Log クラスではなく、次のようなものでログを出します(Flutter docs)。

  • print():いちばん手軽な出し方
  • debugPrint():出力が多くて行が捨てられるときに使う。デバッグのときだけに限る書き方(assert の中など)にしないと、リリースのときも出る
  • dart:developer の log():名前(カテゴリー)を付けたり、細かい情報を一緒に出したりできる

出したログは、DevTools の Logging の画面か、システムのコンソールで見られる、と Flutter docs に書かれています。

Android Studio で Flutter のアプリを止めて、変数の中身を見る方法は、こちらの記事に書いています。

 

以前の Logcat(2022年の Dolphin より前)

古い記事や動画を見ながら探している人のために、前の画面のことも短く残しておきます。

Dolphin より前の Logcat では、ログの種類をプルダウン(Verbose・Debug・Info・Warn・Error など)で選び、検索の欄に文字(正規表現も可)を入れて絞り込んでいました。条件を決めて残したいときは、画面のフィルターの設定の欄を埋めて作る形でした。

今は、このプルダウンやフィルターの欄の代わりに、上で書いた tag:・level: のようなキーで絞り込みます。古い動画どおりにプルダウンを探しても見つからないのは、このためなんです。

下の動画は2017年の収録で、Logcat の画面が今と違う所があります。Log クラスの書き方(タグとメッセージ・種類の使い分け)は今も同じです。絞り込みは、上の今のやり方で行ってください。

 

まとめ

参考:Log(Android Developers、2026年11月21日確認)/View logs with Logcat(Android Developers、2026年11月21日確認)/Android Studio Dolphin のリリースノート(Android Developers、2026年11月21日確認)/Prepare your app for release(Android Developers、2026年11月21日確認)/Debug Flutter apps from code(Flutter docs、2026年11月21日確認)

何かのお役に立てれば幸いです。

  • デバッグログは、Log クラスの Log.d(TAG, "メッセージ") のように、タグとメッセージを書いて出す
  • 種類は VERBOSE・DEBUG・INFO・WARN・ERROR の5つ(ほかに ASSERT の Log.wtf())。例外は3つ目の引数に渡すとスタックトレースも出る
  • 見るのは View → Tool Windows → Logcat。今の Logcat は package:mine・tag:・level: などのキーで絞り込む(Dolphin・2022年から)
  • リリースの前には、ログの呼び出しを消すか、shrinking のルールで取り除く
  • Flutter の Dart の側では print()・debugPrint()・log() を使う

アプリのリリースでお困りですか?
Google Play・App Storeへのリリース支援サービスをご用意しています。
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。

みんプロ式・アプリ開発支援サービス一覧を見る ↗

こんな記事も読まれています

イチオシ

40代から感じるモヤモヤを解消できる 無料動画セミナー

あすコロ式・40代からの人生アップデート【新】戦略

アラフォーでキャリアを失ったバリバリ左脳人間・スピリチュアル耐性ゼロの元金融マンが、人生どん底から立ち上がる過程でたどり着いた「人生再構築メソッド」。40代・50代を過ぎて多くの人が感じる「このままでいいんかな?」「この先どうしたらいいかわからない」というモヤモヤを解消し、人生後半戦をアップデートさせる【新】戦略。

今すぐ無料で動画セミナー(80分)を見る ▶

TOP