Stormを使用したLogHubログの消耗

最終更新日: Apr 17, 2018

Log Service LogHubはLogtail と SDK を使用してリアルタイムでログデータを収集するための効率的で信頼性の高いログチャネルを提供します。ログを収集した後、Spark Stream や Storm などのリアルタイムシステムを使用して LogHub に書き込まれたデータを使用することができます。

Log Service は、LogHub Storm spout を使用して LogHub からリアルタイムでデータを読み取り、Storm ユーザーの LogHub 消費コストを削減します。

基本的なアーキテクチャとプロセス

1

  • 上の図では、LogHub Storm 吐き出し口が赤い点線で囲まれています。各 Stormト ポロジには、Logstore からすべてのデータを読み取るスパウトのグループがあります。異なるトポロジーのスパウトはお互いに影響しません。
  • 各トポロジは、一意の LogHub コンシューマグループ名によって識別されます。同じトポロジのスパウトは、コンシューマライブラリを使用して負荷分散と自動フェールオーバーを実現します。
  • Spouts はリアルタイムで LogHub からデータを読み取り、トポロジーのボルトノードにデータを送信し、Checkpoint として定期的に消費端点を LogHub に保存します。

制限

  • 誤使用を防ぐため、各ログストアは最大 5 つのコンシューマグループをサポートしています。Java SDK の DeleteConsumerGroup インタフェースを使用して、未使用のコンシューマグループを削除できます。
  • スパウトの数はシャードの数と同じであることを推奨します。それ以外の場合、単一のスパウトが大量のデータを処理しないことがあります。
  • シャードに単一スパウトの処理能力を超える大量のデータが含まれている場合は、シャード分割インターフェースを使用してシャードを分割し、各シャードのデータ量を減らすことができます。
  • Storm への依存 LogHub スパウトでスパウトがメッセージを正しくボルトに送信することを確認するには、ACK が必要です。したがって、ボルトは確認のために ACK を呼び出す必要です。

使用例

Spout (トポロジの構築に使用)

  1. public static void main( String[] args )
  2. {
  3. String mode = "Local"; // Use the local test mode.
  4. String conumser_group_name = ""; // Specify a unique consumer group name for each topology. The value cannot be empty. The value can be 3–63 characters long, contain lowercase letters, numbers, hyphens (-), and underscores (_), and must begin and end with a lowercase letter or number.
  5. String project = ""; // The Log Service project.
  6. String logstore = ""; // The Log Service Logstore.
  7. String endpoint = ""; // The domain name used to access Log Service.
  8. String access_id = ""; // Your AccessKey.
  9. String access_key = "";
  10. // Configurations required for building a LogHub Storm spout.
  11. LogHubSpoutConfig config = new LogHubSpoutConfig(conumser_group_name,
  12. endpoint, project, logstore, access_id,
  13. access_key, LogHubCursorPosition.END_CURSOR);
  14. TopologyBuilder builder = new TopologyBuilder();
  15. // Build a LogHub Storm spout.
  16. LogHubSpout spout = new LogHubSpout(config);
  17. // The number of spouts can be the same as that of Logstore shards in actual scenarios.
  18. builder.setSpout("spout", spout, 1);
  19. builder.setBolt("exclaim", new SampleBolt()).shuffleGrouping("spout");
  20. Config conf = new Config();
  21. conf.setDebug(false);
  22. conf.setMaxSpoutPending(1);
  23. // The serialization method LogGroupDataSerializSerializer of LogGroupData must be configured explicitly when Kryo is used for data serialization and deserialization.
  24. Config.registerSerialization(conf, LogGroupData.class, LogGroupDataSerializSerializer.class);
  25. if (mode.equals("Local")) {
  26. logger.info("Local mode...");
  27. LocalCluster cluster = new LocalCluster();
  28. cluster.submitTopology("test-jstorm-spout", conf, builder.createTopology());
  29. try {
  30. Thread.sleep(6000 * 1000); //waiting for several minutes
  31. } catch (InterruptedException e) {
  32. // TODO Auto-generated catch block
  33. e.printStackTrace();
  34. }
  35. cluster.killTopology("test-jstorm-spout");
  36. cluster.shutdown();
  37. } else if (mode.equals("Remote")) {
  38. logger.info("Remote mode...");
  39. conf.setNumWorkers(2);
  40. try {
  41. StormSubmitter.submitTopology("stt-jstorm-spout-4", conf, builder.createTopology());
  42. } catch (AlreadyAliveException e) {
  43. // TODO Auto-generated catch block
  44. e.printStackTrace();
  45. } catch (InvalidTopologyException e) {
  46. // TODO Auto-generated catch block
  47. e.printStackTrace();
  48. }
  49. } else {
  50. logger.error("invalid mode: " + mode);
  51. }
  52. }
  53. }

ボルト

次のボルトコードの例では、データを消費し、各ログの内容のみを出力します。

  1. public class SampleBolt extends BaseRichBolt {
  2. private static final long serialVersionUID = 4752656887774402264L;
  3. private static final Logger logger = Logger.getLogger(BaseBasicBolt.class);
  4. private OutputCollector mCollector;
  5. @Override
  6. public void prepare(@SuppressWarnings("rawtypes") Map stormConf, TopologyContext context,
  7. OutputCollector collector) {
  8. mCollector = collector;
  9. }
  10. @Override
  11. public void execute(Tuple tuple) {
  12. String shardId = (String) tuple
  13. .getValueByField(LogHubSpout.FIELD_SHARD_ID);
  14. @SuppressWarnings("unchecked")
  15. List<LogGroupData> logGroupDatas = (ArrayList<LogGroupData>) tuple.getValueByField(LogHubSpout.FIELD_LOGGROUPS);
  16. for (LogGroupData groupData : logGroupDatas) {
  17. // Each LogGroup consists of one or more logs.
  18. LogGroup logGroup = groupData.GetLogGroup();
  19. for (Log log : logGroup.getLogsList()) {
  20. StringBuilder sb = new StringBuilder();
  21. // Each log has a time field and multiple key-value pairs.
  22. int log_time = log.getTime();
  23. sb.append("LogTime:").append(log_time);
  24. for (Content content : log.getContentsList()) {
  25. sb.append("\t").append(content.getKey()).append(":")
  26. .append(content.getValue());
  27. }
  28. logger.info(sb.toString());
  29. }
  30. }
  31. // The dependency on the Storm ACK is required in LogHub spouts to confirm that spouts correctly send messages to bolts. Therefore, bolts must call ACK for confirmation.
  32. mCollector.ack(tuple);
  33. }
  34. @Override
  35. public void declareOutputFields(OutputFieldsDeclarer declarer) {
  36. //do nothing
  37. }
  38. }

Maven

Storm 1.0 より前のバージョン(たとえば、0.9.6)では、次のコードを使用します。

  1. <dependency>
  2. <groupId>com.aliyun.openservices</groupId>
  3. <artifactId>loghub-storm-spout</artifactId>
  4. <version>0.6.5</version>
  5. </dependency>

Storm 1.0 以降のバージョンでは、次のコードを使用してください。

  1. <dependency>
  2. <groupId>com.aliyun.openservices</groupId>
  3. <artifactId>loghub-storm-1.0-spout</artifactId>
  4. <version>0.1.2</version>
  5. </dependency>