skillup

技術ブログ

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

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

投稿日:

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

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

  • 発生時間
  • 再現動作
  • リクエストパラメータ
  • 特定度の高いデータ

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

ログの見方

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

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

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

デプロイ

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

ありがちな点としては、

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

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

タスクコミュニケーション(タスク管理ツール)

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

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

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

  • フィルタリング機能(担当者、ステータス、期限、その他のカテゴリー)が容易で豊富なこと
  • ID=800のタスクがあった場合、そのページに容易に飛べること(URLの中に入っているなど)
  • チャットのようにメッセージのやりとりができること
  • 更新時にメールが飛ぶ、あるいは更新の検知が容易なこと
  • ファイルの添付ができること

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

チャット

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

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

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

執筆者:


comment

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

関連記事

no image

テスト仕様書の必要な項目の定義など(横項目の定義)

前回はテストの項目をどのように作るか(分類するか)だったんですが、今回はテスト仕様書などを作る際に必要な項目の定義をまとめてみようかと。 テスト仕様書を作るとしたら前回は縦(バリデーションの組み合わせ …

no image

CI/CDに関する取り組み

CI/CDに関して知識としては5年以上昔から持ってましたが、実際にプロジェクトの中に取り組むことができるようになったのはつい最近なので、 取り込みが現実的なものに関してどのように取り組んでいくかといっ …

no image

ドキュメント作成について

アプリやプロジェクトのドキュメント作りですが、時間が立ったり、複数人での開発を行うと 情報の漏れや抜けが非常に多くなる 本番との差分ができる 一部の人しか更新しなくなる 似たようなドキュメントがあちこ …

no image

EntityとValue Objectについて

ドメイン駆動設計に関して勉強しています。参考にしている本がやたら難しいんで、トピックごとにネットで調べつつ進めていくのがよさげです。 今回はEntityとValueObjectについて Content …

no image

設計業務での改善点など

比較的大規模なプロジェクトの設計段階で思ったことなど。 Contents1 明確なゴールを決める2 レビュー時はチェックリストを設ける3 チーム内での情報の情報共有方法を考える4 出来るだけ情報の同期 …

アーカイブ