skillup

技術ブログ

ドキュメント作成 プロジェクト管理

外結〜運用フェーズでの気をつけることなど

投稿日:2022年1月15日 更新日:

外結以降のフェーズで注意することなど。(主に障害発生時の原因切り分け)

エラーの情報伝達に関して

  • 発生時間
  • 再現動作
  • リクエストパラメータ(入力情報)
  • 特定度の高いデータ、特異度の高い情報

データ齟齬によるエラーやコミュニケーションが多いため、外結開始時点でデータ作りを一緒に行っておくのが良いと思います。

連絡してくる方はシステムの知識のあるテスターの方のこともあれば、システムの専門知識がない方もいますが、上記の情報に関しては伝えてもらうことができると思うので、伝達時のマニュアルに入れておきましょう。

ログの見方

システムによってはログの量が非常に膨大になるため、開始時間のヒアリングやログのNoなどを明確にしておくことにより、発見を容易にすることが大切。

サーバーに直で入れない、入れてもログ自体を検索することが容易ではない(通常のサーバーのように扱えない)ことも考慮し、ログ検知ツール(AWSでいうCloudWatch, AzureでいうとApplication Insights)やエラー検知ツール(Sentry)などの活用を考えるべき。

普段から詳細なエラーメッセージ(StackTrace)を出すことを考慮しておく。

当たり前だが、ログやエラーメッセージツールにしっかりと情報を吐き出すようにしておく(そのための検証を前もってしておくことが大切。)

デプロイ

CDのようになるべく自動化できるツールを用意しておく。

ありがちな点としては、

設定ファイルごとに切り分けるべき、環境ごとに分ける情報の書き換えが残ってしまった

が多いため、人手を通さずにデプロイできるようにしておくべき。

タスクコミュニケーション(タスク管理ツール) 主にストック系の情報に関して

現状、解決されていないエラーがどの程度残っているかがわかるようにツールで管理するなど、どのプロジェクトでもあるかとは思います。

記録系の情報を残すのでストック系の情報になると思います。

これまでの経験ではRedmine、Backlog、GoogleSpreadSheet、WBS、他独自テスト管理ツール(CAT)など使ってきました。

基本的にプロジェクトに合えばどれでもいいと思いますが、

  • 各人の作業進捗などが明確にわかること
  • フィルタリング機能(担当者、ステータス、期限、その他のカテゴリー)が容易で豊富なこと
  • ID=800のタスクがあった場合、そのページに容易に飛べること(URLの中に入っているなど)。要は目的の情報に早く辿り着けること。
  • チャットのようにメッセージのやりとりができること(ストック系の情報が残せること。)
  • 更新時にメールが飛ぶ、あるいは更新の検知が容易なこと(気付けないとやばい・・・)
  • ファイルの添付ができること。
  • その他検索機能が優れていること。

内部ではRedmine、外部も含めるとBacklogがベストかな・・と個人的には思います。

チャット 主にフロー系の情報に関して

ここ1年以上ずっとテレワークなので基本やりとりをチャットでするんですよね・・・外部のベンダーともやりとりをするとどうしても必要になってきますし、タスク管理ツールだけだとやはり限界があるので、リアルタイムで必要になってきます。

Microsoft製品を使っているので私はTeams使っているんですけど、一般的にはSlackですかね。

  • ポイントとしては、各人のやり取りがリアルタイムに行えること。
  • メンションを付けることができること。
  • 当たり前ですが、コミニケーションの中心となっていること

一般的にはフロー系の情報だったりするので、ストック系の情報など(決まった仕様などを話し合った場合は)はそれ用のツール(BacklogやRedmine)にまとめておきましょう。

-ドキュメント作成, プロジェクト管理
-,

執筆者:


comment

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です

関連記事

no image

他者への指摘に関して

問題のあるメンバーがいた場合にその点を指摘するのは結構難しいと思うのですが、マネジメントをする場合に避けては通れないと思いますので、指摘するべき指摘事項について。 Contents1 指摘すべきポイン …

no image

読書感想文:ITエンジニア採用とマネジメントの全て

前回に引き続き採用の本の読書感想文を 今回読んだ本は「ITエンジニア採用とマネジメントの全て(久松剛)」です。 著者の方は某大手企業で有名なエンジニアリングマネージャーを務めている方でここ10年ぐらい …

no image

使える設計書作成に関して シーケンス図

使える仕様書ですが、細かいロジックなどシーケンス図も結構役に立つのでは・・と思いましたね。 シーケンス図とは下記のようなものです。 https://cacoo.com/ja/blog/what-is- …

no image

アジャイル開発について

エンジニアとして仕事をしてから7〜8年立ちましたが、その間9割近くはいわゆるアジャイル開発でやってきたと思っていました。今は比較的大規模な開発をしておりますので、ウォータフォールですが・・・ が、先日 …

no image

業務管理アプリの商品コードに関して

一般的な業務管理アプリを作っていると商品や顧客などもオートインクリメントのidではなく、独自の仕様で決められた「商品コード」などを持っていることが一般的です。 昔通販がらみのシステムを使っている時も商 …

アーカイブ