zabbix meeting 2011 oct 22th - zabbixのバグ・パッチ報告の手順 - takanori suzuki

Zabbix のバグ・パッチ報告の手順

Takanori Suzuki

自己紹介● Takanori Suzuki

● 活動– Zabbix-JP のメンバー– バグ報告やパッチ投稿

● Twitter ID– BlueSkyDetector

is OpenSource

● Zabbix のバグトラッキングシステム（ BTS ）● ここでバグやパッチの報告受け付けてます

https://support.zabbix.com/browse/ZBX

OpenSource のエコシステム

ContributeReport bugsPost patches

Transtaleetc...

ContributeReport bugsPost patches

Transtaleetc...

New releaseNew release

UserUserDeveloperDeveloper

活動していく上での指標（？）のようなもの

For example...

- [ZBX-3490] added support for LVM devices and full path to devices to vfs.dev.read and vfs.dev.write; thanks to Takanori Suzuki (dimir, sasha)

● リリース内容が記載されている Changelogに "thanks to" という形で名前が掲載される

● 役に立つバグ・パッチ報告だと掲載される● 経験的には 2 〜 3 回につき 1 回程度記載

Number of fixed bug with “thanks to”per person (Zabbix 1.8.8)

- Top10 -

alixen sébastien kodai takanori nicob zalex_ua james igor igor many...02468

1012

バグ報告の手順

バグ報告前の確認点● 以下のものはバグ報告ではない

● 機能追加の要望 ---> フォーラムか BTS の"ZABBIX FEATURE REQUESTS" を使うべき

● サポートの要望 ---> フォーラムを使うべき● バグかどうか不明なもの ---> フォーラムを使うべき

バグ報告前の確認点● 必須情報

● バグの再現手順とその結果● どう動作すべきか● 環境情報 (OS, version, network など )● BTS(JIRA) で同じバグが報告されていないこと● 最新バージョンでも発生するか確認

● あると望ましい情報● ワークアラウンド● 修正方法

バグ報告● BTS(JIRA) にアカウントを作成

https://support.zabbix.com● 前ページでの情報を含めて "ZABBIX BUGS AND

ISSUES" プロジェクトへバグ登録

● どうしても日本語で報告したい場合は www.zabbix.jp のフォーラム内の「バグ報告」カテゴリへ– ただ、翻訳したりコミュニケーションを中継するため、レスポンスは落ちる

バグ報告

バグ報告後● レスポンスを待つ

● 高プライオリティーだと判断された場合、早く回答が付く

● "ZABBIX BUGS AND ISSUES" プロジェクトのオーナーである richlv からコメントがつくことが多い（ richlv はIRC に 24 時間いるので疑問があったら話しかけてみるといいかも）

● 適切な報告で、適切にコメントに反応していれば修正してくれる（はず）● でも、最近 Zabbix SIA は忙しいらしいので、気長に待ちましょう

パッチ投稿の手順

パッチ投稿前の確認点● "Zabbix Wiki - contribution - 1.5 Patches"

http://www.zabbix.com/wiki/contrib/contributing ● 1.5.1 Patch lifecycle and requirements

– コードを書く前に Zabbix 開発者と議論しておくこと（個人的には、自明なバグで小さな修正の場合は話さずにやってしまっている。。）

– メンテナンスしやすいコードにすること– 互換性へ配慮すること– trunk 用のパッチを作成すること

● 1.5.2 Coding guidelines– ”古いので、次ページの Zabbix Coding Standard” を参照すること

パッチ投稿前の確認点● Zabbix Coding Standard

● Zabbix Conference 2011 の直後 (2011 10/1) に公開http://www.zabbix.org/wiki/Docs/specs/coding_style

● パッチはこの Coding Standard に従って作成すること

● Shell, SQL, C, PHP について記載

パッチ投稿● BTS(JIRA) のバグ報告ページへパッチを投稿● パッチでの修正内容・ロジックを必ず記載

修正内容の説明

投稿したパッチ

パッチ投稿後● バグ報告後とほぼ同様● レスポンスを待つ

● 高プライオリティーだと判断された場合、早く回答が付く● "ZABBIX BUGS AND ISSUES"プロジェクトのオーナーである richlvからコメントがつくことが多い（ richlvは IRCに 24時間いるので疑問があったら話しかけてみるといいかも）

● 適切なパッチで、適切にコメントに反応していれば取り込まれる（はず）● でも、最近Zabbix SIAは忙しいらしいので、気長に待ちましょう● パッチ付きのバグ報告だと対応が早い気がします

バグ報告やパッチ投稿してみませんか？

● 疑問点とかあれば、 Zabbix-JP のフォーラムに書き込んだり、twitter で BlueSkyDetector に気軽に話しかけてください。

Questions

Thank you

The original artwork by orngjce223 is distributed under CC BY license (http://creativecommons.org/licenses/by/3.0/us/)