[{"data":1,"prerenderedAt":712},["ShallowReactive",2],{"news-item-\u002Fja\u002Fnews\u002Fnodejs-winston":3},{"id":4,"title":5,"body":6,"category":699,"created by":700,"date":701,"description":702,"extension":703,"meta":704,"navigation":705,"path":706,"sections":707,"seo":708,"stem":709,"thumbnail":710,"__hash__":711},"content_ja\u002Fja\u002Fnews\u002Fnodejs-winston.md","NODEJS |  WINSTON ライブラリを使ったログ出力",{"type":7,"value":8,"toc":689},"minimark",[9,14,25,29,36,49,57,60,68,73,95,100,114,121,129,138,147,151,164,168,175,273,276,280,283,287,294,360,363,373,379,396,402,405,409,418,421,425,432,438,442,449,452,456,460,467,471,474,478,485,489,496,500,504,507,511,514,518,522,530,533,537,540,544,550,553,557,560,565,569,574,578,582,591,595,603,607,615,619,626,630,637,646,650,657,661,665],[10,11,13],"h2",{"id":12},"i-紹介","I. 紹介",[15,16,18],"h4",{"id":17},"winstonとは",[19,20,21],"strong",{},[22,23,24],"em",{},"Winstonとは?",[26,27,28],"p",{},"Winstonは、複数のトランスポートをサポートする一般的かつ簡潔なログ出力ライブラリーとして作られたものです。Winstonロガーごとに異なるレベルで構成されるトランスポートが複数あり得ます。全てのログはコンソール或いはローカルファイルへ出力されます。 Winstonは、ログ出力プロセスをフラグメント化して柔軟かつ拡張可能性のあるものになることを目的としています。",[15,30,32],{"id":31},"インストール",[19,33,34],{},[22,35,31],{},[26,37,38,43,44],{},[19,39,40],{},[22,41,42],{},"npm install winston"," または ",[19,45,46],{},[22,47,48],{},"yarn add winston",[15,50,52],{"id":51},"プロジェクトへのwinston宣言",[19,53,54],{},[22,55,56],{},"プロジェクトへのWinston宣言",[26,58,59],{},"const winston = require('winston') または import * as winston from 'winston'.",[15,61,63],{"id":62},"winstonver-321リリースノート",[19,64,65],{},[22,66,67],{},"Winston(ver 3.2.1)リリースノート",[26,69,70],{},[22,71,72],{},"変更点",[74,75,76,80,83,86,89,92],"ul",{},[77,78,79],"li",{},"トップレベルのwinston.* API",[77,81,82],{},"トランスポート",[77,84,85],{},"winston.Containerおよびwinston.loggers",[77,87,88],{},"winston.loggers",[77,90,91],{},"例外および例外処理",[77,93,94],{},"他のマイナ変更点",[26,96,97],{},[22,98,99],{},"winston.formatへのアップグレード",[74,101,102,105,108,111],{},[77,103,104],{},"winston.Logger形式オプション削除",[77,106,107],{},"winston.transports.{File,Console,Http}形式オプション削除",[77,109,110],{},"winston@3のformatsへのfiltersおよびrewritersの移植",[77,112,113],{},"winston-transportやlogform等のモジュール化",[26,115,116],{},[19,117,118],{},[22,119,120],{},"詳細について以下のURLを参照のこと",[26,122,123],{},[124,125,126],"a",{"href":126,"rel":127},"https:\u002F\u002Fgithub.com\u002Fwinstonjs\u002Fwinston\u002Fblob\u002FHEAD\u002FUPGRADE-3.0.md",[128],"nofollow",[26,130,131,132,137],{},"Winston使用時、独自ロガーの実装が推薦されます。一番簡単な方法として",[19,133,134],{},[22,135,136],{},"winston.createLogger","を利用することです。",[139,140],"img",{"className":141,"alt":144,"src":145,"style":146},[142,143],"block","mx-auto","","https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25130710\u002F1-1.png","width: 100%;",[10,148,150],{"id":149},"ii-ロギング","II. ロギング",[26,152,153,154,159,160,163],{},"Winstonのロギング・レベルは",[124,155,158],{"href":156,"rel":157},"https:\u002F\u002Ftools.ietf.org\u002Fhtml\u002Frfc5424",[128],"RFC5424","で定義された重大性の順番に準拠しています。各レベルの重大性は",[19,161,162],{},"昇順","に並んでいる整数で定義されており、数値が小さいほど重大性が高いです。",[139,165],{"className":166,"alt":144,"src":167,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25112549\u002F2.png",[15,169,171],{"id":170},"パラメーター",[19,172,173],{},[22,174,170],{},[176,177,178,200],"table",{},[179,180,181],"thead",{},[182,183,184,190,195],"tr",{},[185,186,187],"th",{},[19,188,189],{},"パラメーター名",[185,191,192],{},[19,193,194],{},"デフォルト値",[185,196,197],{},[19,198,199],{},"説明",[201,202,203,215,226,237,251,262],"tbody",{},[182,204,205,209,212],{},[206,207,208],"td",{},"level",[206,210,211],{},"‘info’",[206,213,214],{},"ログはinfo.levelがこのレベル以下の時のみ出力する",[182,216,217,220,223],{},[206,218,219],{},"levels",[206,221,222],{},"winston.config.npm.levels",[206,224,225],{},"レベル（色も）はログの優先度を示す",[182,227,228,231,234],{},[206,229,230],{},"format",[206,232,233],{},"winston.format.json",[206,235,236],{},"infoのメッセージの形式を指定する",[182,238,239,242,248],{},[206,240,241],{},"transports",[206,243,244,245],{},"[] ",[22,246,247],{},"(No transports)",[206,249,250],{},"infoのメッセージのロギング・ターゲットを設定する",[182,252,253,256,259],{},[206,254,255],{},"exitOnError",[206,257,258],{},"true",[206,260,261],{},"偽（false）の場合、例外処理はprocess.exitを呼び出さない",[182,263,264,267,270],{},[206,265,266],{},"silent",[206,268,269],{},"false",[206,271,272],{},"真（true）の場合、全てのログ出力を抑制する",[26,274,275],{},"createLoggerに設定されたレベルは返却されるロガーにて便宜なメソッドとして定義されます。",[139,277],{"className":278,"alt":144,"src":279,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25112611\u002F3.png",[26,281,282],{},"winston.createLoggerから生成されたのち、ロガーからトランスポートを追加または削除することができます。",[139,284],{"className":285,"alt":144,"src":286,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25112643\u002F4.png",[15,288,290],{"id":289},"フォーマットの追加的な属性",[19,291,292],{},[22,293,289],{},[176,295,296,314],{},[179,297,298],{},[182,299,300,305,310],{},[185,301,302],{},[19,303,304],{},"属性",[185,306,307],{},[19,308,309],{},"以下によるフォーマット追加",[185,311,312],{},[19,313,199],{},[201,315,316,327,338,349],{},[182,317,318,321,324],{},[206,319,320],{},"splat",[206,322,323],{},"splat()",[206,325,326],{},"%d %sで文字列を挿入（メッセージスタイル）",[182,328,329,332,335],{},[206,330,331],{},"timestamp",[206,333,334],{},"timestamp()",[206,336,337],{},"メッセージ受取時のタイムスタンプ",[182,339,340,343,346],{},[206,341,342],{},"label",[206,344,345],{},"label()",[206,347,348],{},"各メッセージに設けるカスタマイズラベル",[182,350,351,354,357],{},[206,352,353],{},"ms",[206,355,356],{},"ms()",[206,358,359],{},"直前のメッセージよりミリ秒数",[26,361,362],{},"必要に応じて自由にいずれかの属性を追加することが可能です。内部状態はSymbol属性で維持します。",[26,364,365,368,369,372],{},[22,366,367],{},"Symbol.for('level')"," (",[19,370,371],{},"読取専用","): level属性と同等。全てのコードに変更しません。",[26,374,375,378],{},[22,376,377],{},"Symbol.for('message'):"," “finalizing formats”で指定されたメッセージ",[74,380,381,384,387,390,393],{},[77,382,383],{},"json",[77,385,386],{},"logstash",[77,388,389],{},"printf",[77,391,392],{},"prettyPrint",[77,394,395],{},"simple",[26,397,398,401],{},[22,399,400],{},"Symbol.for('splat')",": 文字列挿入の引数。splat()で使われます。",[26,403,404],{},"注意： metaオブジェクトの 全て{message}属性は提供されたどのメッセージにも自動的に連結されます。以下の例に、'world'は'hello'と連結されます。",[139,406],{"className":407,"alt":144,"src":408,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25112711\u002F5.png",[26,410,411,412,417],{},"WinstonのフォーマットはWinstonからの別のモジュールである",[124,413,416],{"href":414,"rel":415},"https:\u002F\u002Fgithub.com\u002Fwinstonjs\u002Flogform",[128],"logform","に実装され、winston.formatからアクセスできます。これにより独自トランスポートを作る時にフォーマットをデフォルトとして指定したい場合、柔軟に対応できます。",[26,419,420],{},"ログにフォーマットを指定したい場合、winston.format.printfがおすすめです。",[139,422],{"className":423,"alt":144,"src":424,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25112802\u002F6.png",[15,426,428],{"id":427},"フォーマット組合せ",[19,429,430],{},[22,431,427],{},[26,433,434,437],{},[22,435,436],{},"format.combine"," を用いることで複数のフォーマットを単一フォーマットになるように組み合わせることができます。",[139,439],{"className":440,"alt":144,"src":441,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25112821\u002F7.png",[15,443,445],{"id":444},"文字列の挿入",[19,446,447],{},[22,448,444],{},[26,450,451],{},"logメソッドは_format.splat()_を使った文字列の挿入をサポートしますが、format.splat()を用いることで有効化しなければなりません。",[139,453],{"className":454,"alt":144,"src":455,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25112838\u002F8.png",[10,457,459],{"id":458},"iv-ロギングレベル","IV. ロギングレベル",[26,461,462,463,466],{},"レベルの一つずつは優先度としての整数を与えられます。優先度が高いほど、重大性が高いです。それに対して優先度が低いほど、重大性が低いです。以下のように、",[124,464,158],{"href":156,"rel":465},[128],"で定義され、優先度としての整数が0～7、すなわち該当する重大性が一番高いものから一番低いものとなっています。",[139,468],{"className":469,"alt":144,"src":470,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25112922\u002F9.png",[26,472,473],{},"同様に、npmログレベルは0～5（一番高いから一番低い）で定義されます。",[139,475],{"className":476,"alt":144,"src":477,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25112945\u002F10.png",[15,479,481],{"id":480},"ロギングレベルの使用",[19,482,483],{},[22,484,480],{},[139,486],{"className":487,"alt":144,"src":488,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25113006\u002F11.png",[15,490,492],{"id":491},"カスタマイズしたロギングレベルの使用",[19,493,494],{},[22,495,491],{},[139,497],{"className":498,"alt":144,"src":499,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25113037\u002F12.png",[10,501,503],{"id":502},"v-トランスポート","V. トランスポート",[26,505,506],{},"トランスポートを作る時、winston.transports.Fileといった同じタイプのトランスポートを複数利用できます。",[139,508],{"className":509,"alt":144,"src":510,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25113058\u002F13.png",[26,512,513],{},"トランスポートの一つを削除したい場合、そのトランスポート自体を用いることで削除できます。",[139,515],{"className":516,"alt":144,"src":517,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25130411\u002F14.png",[10,519,521],{"id":520},"vi-例外","VI. 例外",[15,523,525],{"id":524},"winstonによって処理されない例外の処理",[19,526,527],{},[22,528,529],{},"Winstonによって処理されない例外の処理",[26,531,532],{},"Winstonでは、処理プロセスからuncaughtExceptionイベントを捕まえ、ログ出力することができます。作った独自ロガーでは、作成時または、アプリケーション・ライフサイクルでこの処理を有効にすることができます。",[139,534],{"className":535,"alt":144,"src":536,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25130350\u002F15.png",[26,538,539],{},"トランスポート・インスタンスで.exceptions.handle()を以下のようにコールすることでデフォルトロガーとしてこの機能を利用できます。",[139,541],{"className":542,"alt":144,"src":543,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25130227\u002F16.png",[15,545,547],{"id":546},"終了非終了",[19,548,549],{},"終了・非終了",[26,551,552],{},"WinstonはデフォルトとしてunsceptionExceptionのログが出力した後に終了します。終了したくない場合、exitOnError = falseで設定しなければなりません。",[139,554],{"className":555,"alt":144,"src":556,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25130204\u002F17.png",[26,558,559],{},"カストマイズ・ロガーでは、別々のexceptionHandlersの属性へトランスポートをセットし、または、handleExceptionsをトランスポートに設定することができます。",[26,561,562],{},[19,563,564],{},"例１",[139,566],{"className":567,"alt":144,"src":568,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25130147\u002F18.png",[26,570,571],{},[19,572,573],{},"例２",[139,575],{"className":576,"alt":144,"src":577,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25125928\u002F19.png",[10,579,581],{"id":580},"vii-query-logs","VII. QUERY LOGS.",[26,583,584,585,590],{},"Winstonは",[124,586,589],{"href":587,"rel":588},"https:\u002F\u002Fwww.loggly.com\u002Fdocs\u002Fapi-retrieving-data\u002F",[128],"Loggly","のようなオプションでログクエリをサポートしています。特に、File、Couchdb、Redis、Loggly、Nssocket、Httpです。",[139,592],{"className":593,"alt":144,"src":594,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25125833\u002F20.png",[15,596,598],{"id":597},"winstonインストール",[19,599,600],{},[22,601,602],{},"Winstonインストール",[139,604],{"className":605,"alt":144,"src":606,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25125755\u002Fnpmi-1.png",[15,608,610],{"id":609},"winstonts生成",[19,611,612],{},[22,613,614],{},"winston.ts生成",[139,616],{"className":617,"alt":144,"src":618,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25125516\u002Fwinston.png",[15,620,622],{"id":621},"ログ出力",[19,623,624],{},[22,625,621],{},[139,627],{"className":628,"alt":144,"src":629,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25125457\u002Fapi.png",[15,631,633],{"id":632},"検証",[19,634,635],{},[22,636,632],{},[26,638,639,640,645],{},"PostManを使ってAPIを実行します。",[124,641,644],{"href":642,"rel":643},"http:\u002F\u002Flocalhost:8081\u002Fv1\u002Fuser\u002F101",[128],"http:\u002F\u002Flocalhost:8081\u002Fv1\u002Fuser\u002F1"," (Idが存在している場合)",[139,647],{"className":648,"alt":144,"src":649,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25125430\u002Finfo.png",[26,651,639,652,656],{},[124,653,655],{"href":644,"rel":654},[128],"http:\u002F\u002Flocalhost:8081\u002Fv1\u002Fuser\u002F2"," (Idが存在しない場合)",[139,658],{"className":659,"alt":144,"src":660,"style":146},[142,143],"https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F25125408\u002Fwarn.png",[10,662,664],{"id":663},"ix-参考元","IX. 参考元",[74,666,667,673,678,684],{},[77,668,669],{},[124,670,671],{"href":671,"rel":672},"https:\u002F\u002Fgithub.com\u002Fwinstonjs\u002Fwinston\u002Fblob\u002Fmaster\u002Fdocs\u002Ftransports.md",[128],[77,674,675],{},[124,676,414],{"href":414,"rel":677},[128],[77,679,680],{},[124,681,682],{"href":682,"rel":683},"https:\u002F\u002Fgithub.com\u002Fwinstonjs\u002Fwinston\u002Ftree\u002F2.x",[128],[77,685,686],{},[124,687,587],{"href":587,"rel":688},[128],{"title":144,"searchDepth":690,"depth":690,"links":691},2,[692,693,694,695,696,697,698],{"id":12,"depth":690,"text":13},{"id":149,"depth":690,"text":150},{"id":458,"depth":690,"text":459},{"id":502,"depth":690,"text":503},{"id":520,"depth":690,"text":521},{"id":580,"depth":690,"text":581},{"id":663,"depth":690,"text":664},"tech talk","Briswell Vietnam Co Ltd","2020-05-20","I. 紹介 Winstonとは? Winstonは、複数のトランスポートをサポートする一般的かつ簡潔なログ出力ライブラリーとして作られたものです。Winstonロガーごとに異なるレベルで構成されるトランスポートが複数あり得ます。全てのログはコンソール或いはローカルファイルへ出力されます。 Winstonは、ログ出力プロセスをフラグメント化して柔軟かつ拡張可能性のあるものになることを目的としています。","md",{},true,"\u002Fja\u002Fnews\u002Fnodejs-winston",null,{"title":5,"description":702},"ja\u002Fnews\u002Fnodejs-winston","https:\u002F\u002Fhomepage-media.s3.ap-southeast-1.amazonaws.com\u002Fwp-content\u002Fuploads\u002F2020\u002F05\u002F19094352\u002Fnodejs_logo.png","F0JJZT3Iqj0bfxeKMcCQDsEergjov-rCpDOOGkdJGRA",1785320532645]