

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Firehose
<a name="kinesis-firehose-component"></a>

Firehose 元件 (`aws.greengrass.KinesisFirehose`) 透過 Amazon Data Firehose 交付串流發佈資料到目的地，例如 Amazon S3、Amazon Redshift 和 Amazon OpenSearch Service。如需詳細資訊，請參閱《[Amazon Data Firehose 開發人員指南》中的什麼是](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html) *Amazon Data Firehose*？。

若要使用此元件發佈至 Kinesis 交付串流，請將訊息發佈至此元件訂閱的主題。根據預設，此元件會訂閱 `kinesisfirehose/message`和`kinesisfirehose/message/binary/#`[本機發佈/訂閱](ipc-publish-subscribe.md)主題。您可以在部署此元件時指定其他主題，包括 AWS IoT Core MQTT 主題。

**注意**  
此元件提供與 Firehose 連接器 in AWS IoT Greengrass V1 類似的功能。如需詳細資訊，請參閱《*AWS IoT Greengrass V1 開發人員指南*》中的 [Firehose 連接器](https://docs.aws.amazon.com/greengrass/latest/developerguide/kinesis-firehose-connector.html)。

**Topics**
+ [版本](#kinesis-firehose-component-versions)
+ [Type](#kinesis-firehose-component-type)
+ [作業系統](#kinesis-firehose-component-os-support)
+ [要求](#kinesis-firehose-component-requirements)
+ [相依性](#kinesis-firehose-component-dependencies)
+ [Configuration](#kinesis-firehose-component-configuration)
+ [輸入資料](#kinesis-firehose-component-input-data)
+ [輸出資料](#kinesis-firehose-component-output-data)
+ [本機日誌檔案](#kinesis-firehose-component-log-file)
+ [授權](#kinesis-firehose-component-licenses)
+ [變更記錄](#kinesis-firehose-component-changelog)
+ [另請參閱](#kinesis-firehose-component-see-also)

## 版本
<a name="kinesis-firehose-component-versions"></a>

此元件具有下列版本：
+ 2.1.x
+ 2.0.x

## Type
<a name="kinesis-firehose-component-type"></a>

<a name="public-component-type-lambda"></a>此<a name="public-component-type-lambda-phrase"></a>元件是 Lambda 元件 (`aws.greengrass.lambda`)。[Greengrass 核](greengrass-nucleus-component.md)會使用 Lambda [啟動器元件執行此元件的 Lambda](lambda-launcher-component.md) 函數。

<a name="public-component-type-more-information"></a>如需詳細資訊，請參閱[元件類型](develop-greengrass-components.md#component-types)。

## 作業系統
<a name="kinesis-firehose-component-os-support"></a>

此元件只能在 Linux 核心裝置上安裝。

## 要求
<a name="kinesis-firehose-component-requirements"></a>

此元件有下列需求：
+ <a name="core-device-lambda-function-requirements"></a>您的核心裝置必須符合執行 Lambda 函數的要求。如果您希望核心裝置執行容器化 Lambda 函數，則裝置必須符合執行此作業的要求。如需詳細資訊，請參閱[Lambda 函數需求](setting-up.md#greengrass-v2-lambda-requirements)。
+ <a name="public-component-python3-requirement"></a>安裝在核心裝置上並新增至 PATH 環境變數的 [Python](https://www.python.org/) 3.7 版。
+ [Greengrass 裝置角色](device-service-role.md)必須允許 `firehose:PutRecord`和 `firehose:PutRecordBatch`動作，如下列範例 IAM 政策所示。

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Action": [
          "firehose:PutRecord",
          "firehose:PutRecordBatch"
        ],
        "Effect": "Allow",
        "Resource": [
          "arn:aws:firehose:{{us-east-1}}:{{123456789012}}:deliverystream/{{stream-name}}"
        ]
      }
    ]
  }
  ```

------

  您可以動態覆寫此元件輸入訊息承載中的預設交付串流。如果您的應用程式使用此功能，IAM 政策必須包含所有目標串流做為資源。您可以為資源授予精細或條件式存取 (例如，使用萬用字元 `*` 命名機制)。
+ <a name="connector-component-legacy-subscription-router-dependency"></a>若要從此元件接收輸出資料，您必須在部署此元件時合併[舊版訂閱路由器元件](legacy-subscription-router-component.md) (`aws.greengrass.LegacySubscriptionRouter`) 的下列組態更新。此組態會指定此元件發佈回應的主題。

------
#### [ Legacy subscription router v2.1.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-kinesisfirehose": {
        "id": "aws-greengrass-kinesisfirehose",
        "source": "component:aws.greengrass.KinesisFirehose",
        "subject": "kinesisfirehose/message/status",
        "target": "cloud"
      }
    }
  }
  ```

------
#### [ Legacy subscription router v2.0.x ]

  ```
  {
    "subscriptions": {
      "aws-greengrass-kinesisfirehose": {
        "id": "aws-greengrass-kinesisfirehose",
        "source": "arn:aws:lambda:{{region}}:aws:function:aws-greengrass-kinesisfirehose:{{version}}",
        "subject": "kinesisfirehose/message/status",
        "target": "cloud"
      }
    }
  }
  ```<a name="connector-component-legacy-subscription-router-dependency-replace"></a>
  + 以您使用 AWS 區域 的 取代{{區域}}。
  + {{}} 以此元件執行的 Lambda 函數版本取代 版本。若要尋找 Lambda 函數版本，您必須檢視要部署之此元件版本的配方。在[AWS IoT Greengrass 主控台](https://console.aws.amazon.com//greengrass)中開啟此元件的詳細資訊頁面，並尋找 **Lambda 函數**鍵值對。此鍵/值對包含 Lambda 函數的名稱和版本。

**重要**  <a name="connector-component-legacy-subscription-router-dependency-note"></a>
每次部署此元件時，都必須更新舊版訂閱路由器上的 Lambda 函數版本。這可確保針對您部署的元件版本使用正確的 Lambda 函數版本。

------

  <a name="connector-component-create-deployments"></a>如需詳細資訊，請參閱[建立部署](create-deployments.md)。
+ Firehose 元件支援在 VPC 中執行。若要在 VPC 中部署此元件，需要下列項目。
  + Firehose 元件必須具有`firehose.region.amazonaws.com`具有 VPC 端點 的連線`com.amazonaws.region.kinesis-firehose`能力。

### 端點和連接埠
<a name="kinesis-firehose-component-endpoints"></a>

除了基本操作所需的端點和連接埠之外，此元件還必須能夠對下列端點和連接埠執行傳出請求。如需詳細資訊，請參閱[允許透過代理或防火牆的裝置流量](allow-device-traffic.md)。


| Endpoint | 站點 | 必要 | Description | 
| --- | --- | --- | --- | 
|  `firehose.{{region}}.amazonaws.com`  | 443 | 是 |  將資料上傳至 Firehose。  | 

## 相依性
<a name="kinesis-firehose-component-dependencies"></a>

當您部署元件時， AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的要求，才能成功部署元件。本節列出此元件[發行版本的](#kinesis-firehose-component-changelog)相依性，以及為每個相依性定義元件版本的語意版本限制。您也可以在 [AWS IoT Greengrass 主控台](https://console.aws.amazon.com//greengrass)中檢視每個版本元件的相依性。在元件詳細資訊頁面上，尋找**相依性**清單。

------
#### [ 2.1.10 ]

下表列出此元件 2.1.10 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [字符交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.1.9 ]

下表列出此元件 2.1.9 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [權杖交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.1.8 ]

下表列出此元件 2.1.8 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [字符交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.1.7 ]

下表列出此元件 2.1.7 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [字符交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.1.6 ]

下表列出此元件 2.1.6 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [字符交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.1.5 ]

下表列出此元件 2.1.5 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [字符交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.1.4 ]

下表列出此元件 2.1.4 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [權杖交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.1.3 ]

下表列出此元件 2.1.3 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [權杖交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.1.2 ]

下表列出此元件 2.1.2 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [權杖交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.1.1 ]

下表列出此元件 2.1.1 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [權杖交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.0.8 - 2.1.0 ]

下表列出此元件 2.0.8 和 2.1.0 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [權杖交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.0.7 ]

下表列出此元件 2.0.7 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [權杖交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.0.6 ]

下表列出此元件 2.0.6 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [字符交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.0.5 ]

下表列出此元件 2.0.5 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [權杖交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.0.4 ]

下表列出此元件 2.0.4 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | ^2.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | ^2.0.0  | 軟式 | 
| [字符交換服務](token-exchange-service-component.md) | ^2.0.0  | 硬式 | 

------
#### [ 2.0.3 ]

下表列出此元件 2.0.3 版的相依性。


| 相依性 | 相容版本 | 相依性類型 | 
| --- | --- | --- | 
| [Greengrass 核](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0  | 硬式 | 
| [Lambda 啟動器](lambda-launcher-component.md) | >=1.0.0  | 硬式 | 
| [Lambda 執行階段](lambda-runtimes-component.md) | >=1.0.0  | 軟式 | 
| [字符交換服務](token-exchange-service-component.md) | >=1.0.0  | 硬式 | 

------

如需元件相依性的詳細資訊，請參閱[元件配方參考](component-recipe-reference.md#recipe-reference-component-dependencies)。

## Configuration
<a name="kinesis-firehose-component-configuration"></a>

此元件提供下列組態參數，您可以在部署元件時自訂這些參數。

**注意**  <a name="connector-component-lambda-parameters"></a>
此元件的預設組態包含 Lambda 函數參數。建議您只編輯下列參數，以在裝置上設定此元件。

`lambdaParams`  
包含此元件 Lambda 函數參數的物件。此物件包含下列資訊：    
`EnvironmentVariables`  
包含 Lambda 函數參數的物件。此物件包含下列資訊：    
`DEFAULT_DELIVERY_STREAM_ARN`  
元件傳送資料之預設 Firehose 交付串流的 ARN。您可以使用輸入訊息承載中的 `delivery_stream_arn` 屬性覆寫目的地串流。  
核心裝置角色必須允許對所有目標交付串流執行必要的動作。如需詳細資訊，請參閱[要求](#kinesis-firehose-component-requirements)。  
`PUBLISH_INTERVAL`  
（選用） 在元件將批次資料發佈至 Firehose 之前等待的秒數上限。若要設定元件在接收指標時發佈指標，這表示無需批次處理，請指定 `0`。  
此值最多可達 900 秒。  
預設：10 秒  
`DELIVERY_STREAM_QUEUE_SIZE`  
（選用） 在元件拒絕相同交付串流的新記錄之前，要保留在記憶體中的記錄數目上限。  
此值必須至少為 2，000 筆記錄。  
預設：5，000 筆記錄

`containerMode`  <a name="connector-component-container-mode-parameter"></a>
（選用） 此元件的容器化模式。您可以從以下選項中選擇：  <a name="lambda-function-component-container-mode-parameter"></a>
+ `NoContainer` – 元件不會在隔離的執行時間環境中執行。
+ `GreengrassContainer` – 元件會在 AWS IoT Greengrass 容器內的隔離執行時間環境中執行。
預設：`GreengrassContainer`

`containerParams`  
<a name="connector-component-container-params-description"></a>（選用） 包含此元件容器參數的物件。如果您`GreengrassContainer`為 指定 ，元件會使用這些參數`containerMode`。  
此物件包含下列資訊：    
`memorySize`  
<a name="connector-component-container-params-memory-size-description"></a>（選用） 要配置給元件的記憶體量 （以 KB 為單位）。  
預設為 64 MB (65，535 KB)。

`pubsubTopics`  <a name="connector-component-pubsub-topics-parameter"></a>
（選用） 物件，其中包含元件訂閱接收訊息的主題。您可以指定每個主題，以及元件是從 或 AWS IoT Core 本機發佈/訂閱主題訂閱 MQTT 主題。  
此物件包含下列資訊：    
`0` – 這是做為字串的陣列索引。  
包含下列資訊的物件：    
`type`  
（選用） 此元件用來訂閱訊息的發佈/訂閱訊息類型。您可以從以下選項中選擇：  
+ `PUB_SUB` - 訂閱本機發佈/訂閱訊息。如果您選擇此選項，主題不能包含 MQTT 萬用字元。如需在指定此選項時如何從自訂元件傳送訊息的詳細資訊，請參閱 [發佈/訂閱本機訊息](ipc-publish-subscribe.md)。
+ `IOT_CORE` – 訂閱 AWS IoT Core MQTT 訊息。如果您選擇此選項，主題可以包含 MQTT 萬用字元。如需在指定此選項時如何從自訂元件傳送訊息的詳細資訊，請參閱 [發佈/訂閱 AWS IoT Core MQTT 訊息](ipc-iot-core-mqtt.md)。
預設：`PUB_SUB`  
`topic`  
（選用） 元件訂閱接收訊息的主題。如果您`IotCore`為 指定 `type`，則可以在本主題中使用 MQTT 萬用字元 (`+` 和 `#`)。

**Example 範例：組態合併更新 （容器模式）**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_DELIVERY_STREAM_ARN": "arn:aws:firehose:us-west-2:123456789012:deliverystream/mystream"
    }
  },
  "containerMode": "GreengrassContainer"
}
```

**Example 範例：組態合併更新 （無容器模式）**  

```
{
  "lambdaExecutionParameters": {
    "EnvironmentVariables": {
      "DEFAULT_DELIVERY_STREAM_ARN": "arn:aws:firehose:us-west-2:123456789012:deliverystream/mystream"
    }
  },
  "containerMode": "NoContainer"
}
```

## 輸入資料
<a name="kinesis-firehose-component-input-data"></a>

此元件接受下列主題的串流內容，並將內容傳送至目標交付串流。元件接受兩種類型的輸入資料：
+ `kinesisfirehose/message` 主題上的 JSON 資料。
+ `kinesisfirehose/message/binary/#` 主題上的二進位資料。

**JSON 資料的預設主題 （本機發佈/訂閱）：** `kinesisfirehose/message`  
<a name="connector-component-input-properties"></a>訊息接受下列屬性。輸入訊息必須是 JSON 格式。    
`request`  
要傳送到交付串流和目標交付串流 (如果與預設串流不同) 的資料。  
類型：`object`包含下列資訊：    
`data`  
要傳送到交付串流的資料。  
類型：`string`  
`delivery_stream_arn`  
（選用） 目標 Firehose 交付串流的 ARN。指定此屬性以覆寫預設交付串流。  
類型：`string`  
`id`  <a name="connector-component-input-property-id"></a>
請求的任意 ID。使用此屬性將輸入請求映射至輸出回應。當您指定此屬性時，元件會將回應物件中的 `id` 屬性設定為此值。  
類型：`string`

**Example 範例輸入**  

```
{
  "request": {
    "delivery_stream_arn": "arn:aws:firehose:{{region}}:{{account-id}}:deliverystream/stream2-name",
    "data": "Data to send to the delivery stream."
  },
  "id": "request123"
}
```

**二進位資料的預設主題 （本機發佈/訂閱）：** `kinesisfirehose/message/binary/#`  
使用此主題傳送包含二進位資料的訊息。元件不會剖析二進位資料。元件會依原樣串流資料。  
若要將輸入請求映射到輸出回應，請將訊息主題中的 `#` 萬用字元換成任意請求 ID。例如，如果您將訊息發佈到 `kinesisfirehose/message/binary/request123`，回應物件中的 `id` 屬性會設為 `request123`。  
如果您不想將請求映射到回應，您可以將訊息發佈到 `kinesisfirehose/message/binary/`。請務必包含結尾斜線 (`/`)。

## 輸出資料
<a name="kinesis-firehose-component-output-data"></a>

 <a name="connector-component-output-data"></a>此元件預設會將回應發佈為下列 MQTT 主題的輸出資料。您必須將此主題指定為[舊版訂閱路由器元件](legacy-subscription-router-component.md)組態`subject`中的 。如需如何在自訂元件中訂閱此主題訊息的詳細資訊，請參閱 [發佈/訂閱 AWS IoT Core MQTT 訊息](ipc-iot-core-mqtt.md)。

**預設主題 (AWS IoT Core MQTT)：** `kinesisfirehose/message/status`

**Example 範例輸出**  
回應中包含批次中所傳送之各筆資料記錄的狀態。  

```
{
  "response": [
    {
      "ErrorCode": "error",
      "ErrorMessage": "test error",
      "id": "request123",
      "status": "fail"
    },
    {
      "firehose_record_id": "xyz2",
      "id": "request456",
      "status": "success"
    },
    {
      "firehose_record_id": "xyz3",
      "id": "request890",
      "status": "success"
    }
  ]
}
```

**注意**  <a name="connector-component-retryable-error"></a>
如果元件偵測到可以重試的錯誤，例如連線錯誤，它會在下一個批次中重試發佈。

## 本機日誌檔案
<a name="kinesis-firehose-component-log-file"></a>

此元件使用以下日誌檔案。

```
{{/greengrass/v2}}/logs/aws.greengrass.KinesisFirehose.log
```

**檢視此元件的日誌**
+ 在核心裝置上執行下列命令，以即時檢視此元件的日誌檔案。`{{/greengrass/v2}}` 將 取代為 AWS IoT Greengrass 根資料夾的路徑。

  ```
  sudo tail -f {{/greengrass/v2}}/logs/aws.greengrass.KinesisFirehose.log
  ```

## 授權
<a name="kinesis-firehose-component-licenses"></a>

此元件包含下列第三方軟體/授權：<a name="boto-3-licenses"></a>
+ [適用於 Python (Boto3) 的 AWS SDK](https://pypi.org/project/boto3/)/Apache License 2.0
+ [botocore](https://pypi.org/project/botocore/)/Apache License 2.0
+ [dateutil](https://pypi.org/project/python-dateutil/1.4/)/PSF License
+ [docutils](https://pypi.org/project/docutils/)/BSD 授權、GNU 一般公有授權 (GPL)、Python 軟體基金會授權、公有網域
+ [jmespath](https://pypi.org/project/jmespath/)/MIT License
+ [s3transfer](https://pypi.org/project/s3transfer/)/Apache License 2.0
+ [urllib3](https://pypi.org/project/urllib3/)/MIT License

<a name="component-core-software-license"></a>此元件根據 [Greengrass 核心軟體授權合約](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)發行。

## 變更記錄
<a name="kinesis-firehose-component-changelog"></a>

下表說明每個版本元件的變更。


|  **版本**  |  **變更**  | 
| --- | --- | 
|  2.1.10  | 針對 Greengrass nucleus 2.15.0 版更新版本。 | 
|  2.1.9  | 針對 Greengrass nucleus 2.14.0 版更新版本。 | 
|  2.1.8  | 針對 Greengrass nucleus 2.13.0 版更新版本。 | 
|  2.1.7  | 針對 Greengrass nucleus 2.12.0 版更新版本。 | 
|  2.1.6  | 針對 Greengrass nucleus 2.11.0 版更新版本。 | 
|  2.1.5  | 針對 Greengrass nucleus 2.10.0 版更新版本。 | 
|  2.1.4  | 針對 Greengrass nucleus 2.9.0 版更新版本。 | 
|  2.1.3  | 針對 Greengrass nucleus 2.8.0 版更新版本。 | 
|  2.1.2  |  針對 Greengrass nucleus 2.7.0 版更新版本。  | 
|  2.1.1  |  針對 Greengrass nucleus 2.6.0 版更新版本。  | 
|  2.1.0  |  [See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/greengrass/v2/developerguide/kinesis-firehose-component.html)  | 
|  2.0.8  |  針對 Greengrass nucleus 2.5.0 版更新版本。  | 
|  2.0.7  |  針對 Greengrass nucleus 2.4.0 版更新版本。  | 
|  2.0.6  |  針對 Greengrass nucleus 2.3.0 版更新版本。  | 
|  2.0.5  |  針對 Greengrass nucleus 2.2.0 版更新版本。  | 
|  2.0.4  |  針對 Greengrass nucleus 2.1.0 版更新版本。  | 
|  2.0.3  |  初始版本。  | 

## 另請參閱
<a name="kinesis-firehose-component-see-also"></a>
+ 《[Amazon Data Firehose 開發人員指南》中的什麼是](https://docs.aws.amazon.com/firehose/latest/dev/what-is-this-service.html) *Amazon Data Firehose*？